dreaction-client-core 1.2.2 → 1.4.0

package/lib/plugins/index.js

@@ -0,0 +1,36 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.corePlugins = exports.issue = exports.clear = exports.apiResponse = exports.stateResponses = exports.benchmark = exports.image = exports.logger = void 0;
+const logger_1 = __importDefault(require("./logger"));
+const image_1 = __importDefault(require("./image"));
+const benchmark_1 = __importDefault(require("./benchmark"));
+const state_responses_1 = __importDefault(require("./state-responses"));
+const api_response_1 = __importDefault(require("./api-response"));
+const clear_1 = __importDefault(require("./clear"));
+const issue_1 = __importDefault(require("./issue"));
+var logger_2 = require("./logger");
+Object.defineProperty(exports, "logger", { enumerable: true, get: function () { return __importDefault(logger_2).default; } });
+var image_2 = require("./image");
+Object.defineProperty(exports, "image", { enumerable: true, get: function () { return __importDefault(image_2).default; } });
+var benchmark_2 = require("./benchmark");
+Object.defineProperty(exports, "benchmark", { enumerable: true, get: function () { return __importDefault(benchmark_2).default; } });
+var state_responses_2 = require("./state-responses");
+Object.defineProperty(exports, "stateResponses", { enumerable: true, get: function () { return __importDefault(state_responses_2).default; } });
+var api_response_2 = require("./api-response");
+Object.defineProperty(exports, "apiResponse", { enumerable: true, get: function () { return __importDefault(api_response_2).default; } });
+var clear_2 = require("./clear");
+Object.defineProperty(exports, "clear", { enumerable: true, get: function () { return __importDefault(clear_2).default; } });
+var issue_2 = require("./issue");
+Object.defineProperty(exports, "issue", { enumerable: true, get: function () { return __importDefault(issue_2).default; } });
+exports.corePlugins = [
+    (0, image_1.default)(),
+    (0, logger_1.default)(),
+    (0, benchmark_1.default)(),
+    (0, state_responses_1.default)(),
+    (0, api_response_1.default)(),
+    (0, clear_1.default)(),
+    (0, issue_1.default)(),
+];

package/lib/plugins/issue.d.ts

@@ -0,0 +1,19 @@
+import type { DReactionCore, InferFeatures } from '../types';
+/**
+ * Provides issue reporting feature
+ */
+declare const issue: () => (dreaction: DReactionCore) => {
+    features: {
+        reportIssue: (id: string, name?: string, description?: string) => void;
+    };
+};
+export default issue;
+export type IssuePlugin = ReturnType<typeof issue>;
+export type IssueFeatures = InferFeatures<ReturnType<typeof issue>>;
+export declare const hasIssuePlugin: (client: DReactionCore) => client is DReactionCore & {
+    reportIssue: (id: string, name?: string, description?: string) => void;
+};
+export declare const assertHasIssuePlugin: (client: DReactionCore) => asserts client is DReactionCore & {
+    reportIssue: (id: string, name?: string, description?: string) => void;
+};
+//# sourceMappingURL=issue.d.ts.map

package/lib/plugins/issue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue.d.ts","sourceRoot":"","sources":["../../src/plugins/issue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAU,aAAa,EAAE,MAAM,UAAU,CAAC;AAGrE;;GAEG;AACH,QAAA,MAAM,KAAK,oBAAqB,aAAa;;0BAGrB,MAAM,SAAS,MAAM,gBAAgB,MAAM;;CAKlE,CAAC;AAEF,eAAe,KAAK,CAAC;AAErB,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC;AACnD,MAAM,MAAM,aAAa,GAAG,aAAa,CAAC,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC;AAIpE,eAAO,MAAM,cAAc;sBAdH,MAAM,SAAS,MAAM,gBAAgB,MAAM;CAcvB,CAAC;AAC7C,eAAO,MAAM,oBAAoB;sBAfT,MAAM,SAAS,MAAM,gBAAgB,MAAM;CAed,CAAC"}

package/lib/plugins/issue.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertHasIssuePlugin = exports.hasIssuePlugin = void 0;
+const plugin_guard_1 = require("../utils/plugin-guard");
+/**
+ * Provides issue reporting feature
+ */
+const issue = () => (dreaction) => {
+    return {
+        features: {
+            reportIssue: (id, name, description) => {
+                dreaction.send('report.issue', { id, name, description }, true);
+            },
+        },
+    };
+};
+exports.default = issue;
+const issueGuard = (0, plugin_guard_1.createPluginGuard)(['reportIssue'], 'issue');
+exports.hasIssuePlugin = issueGuard.has;
+exports.assertHasIssuePlugin = issueGuard.assert;

package/lib/plugins/logger.d.ts

@@ -1,6 +1,6 @@
-import type { DReactionCore, InferFeatures } from '../';
+import type { DReactionCore, InferFeatures } from '../types';
 /**
- * Provides 4 features for logging.  log & debug are the same.
+ * Provides logging features: log, info, debug, warn, error
  */
 declare const logger: () => (dreaction: DReactionCore) => {
     features: {
@@ -9,11 +9,26 @@ declare const logger: () => (dreaction: DReactionCore) => {
         logImportant: (...args: any[]) => void;
         debug: (message: any, important?: any) => void;
         warn: (message: any) => void;
-        error: (message: any, stack: any) => void;
+        error: (message: any, stack?: any) => void;
     };
 };
 export default logger;
 export type LoggerPlugin = ReturnType<typeof logger>;
-export declare const hasLoggerPlugin: (dreaction: DReactionCore) => dreaction is DReactionCore & InferFeatures<DReactionCore, ReturnType<typeof logger>>;
-export declare const assertHasLoggerPlugin: (dreaction: DReactionCore) => asserts dreaction is DReactionCore & InferFeatures<DReactionCore, ReturnType<typeof logger>>;
+export type LoggerFeatures = InferFeatures<ReturnType<typeof logger>>;
+export declare const hasLoggerPlugin: (client: DReactionCore) => client is DReactionCore & {
+    log: (...args: any[]) => void;
+    info: (...args: any[]) => void;
+    logImportant: (...args: any[]) => void;
+    debug: (message: any, important?: any) => void;
+    warn: (message: any) => void;
+    error: (message: any, stack?: any) => void;
+};
+export declare const assertHasLoggerPlugin: (client: DReactionCore) => asserts client is DReactionCore & {
+    log: (...args: any[]) => void;
+    info: (...args: any[]) => void;
+    logImportant: (...args: any[]) => void;
+    debug: (message: any, important?: any) => void;
+    warn: (message: any) => void;
+    error: (message: any, stack?: any) => void;
+};
 //# sourceMappingURL=logger.d.ts.map

package/lib/plugins/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/plugins/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAU,aAAa,EAAE,MAAM,KAAK,CAAC;AAEhE;;GAEG;AACH,QAAA,MAAM,MAAM,oBAAqB,aAAa;;;;;;;;;CAuB7C,CAAC;AAEF,eAAe,MAAM,CAAC;AAEtB,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,MAAM,CAAC,CAAC;AAErD,eAAO,MAAM,eAAe,cACf,aAAa,KACvB,SAAS,IAAI,aAAa,GAC3B,aAAa,CAAC,aAAa,EAAE,UAAU,CAAC,OAAO,MAAM,CAAC,CAgBvD,CAAC;AAEF,eAAO,MAAM,qBAAqB,cACrB,aAAa,KACvB,QAAQ,SAAS,IAAI,aAAa,GACnC,aAAa,CAAC,aAAa,EAAE,UAAU,CAAC,OAAO,MAAM,CAAC,CAMvD,CAAC"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/plugins/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAU,aAAa,EAAE,MAAM,UAAU,CAAC;AAGrE;;GAEG;AACH,QAAA,MAAM,MAAM,oBAAqB,aAAa;;uBAGzB,GAAG,EAAE;wBAIJ,GAAG,EAAE;gCAIG,GAAG,EAAE;;;;;CAYlC,CAAC;AAEF,eAAe,MAAM,CAAC;AAEtB,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,MAAM,CAAC,CAAC;AACrD,MAAM,MAAM,cAAc,GAAG,aAAa,CAAC,UAAU,CAAC,OAAO,MAAM,CAAC,CAAC,CAAC;AAOtE,eAAO,MAAM,eAAe;mBAhCP,GAAG,EAAE;oBAIJ,GAAG,EAAE;4BAIG,GAAG,EAAE;;;;CAwBW,CAAC;AAC/C,eAAO,MAAM,qBAAqB;mBAjCb,GAAG,EAAE;oBAIJ,GAAG,EAAE;4BAIG,GAAG,EAAE;;;;CAyBoB,CAAC"}

package/lib/plugins/logger.js

@@ -1,22 +1,23 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.assertHasLoggerPlugin = exports.hasLoggerPlugin = void 0;
+const plugin_guard_1 = require("../utils/plugin-guard");
 /**
- * Provides 4 features for logging.  log & debug are the same.
+ * Provides logging features: log, info, debug, warn, error
  */
 const logger = () => (dreaction) => {
     return {
         features: {
             log: (...args) => {
-                const content = args && args.length === 1 ? args[0] : args;
+                const content = args.length === 1 ? args[0] : args;
                 dreaction.send('log', { level: 'debug', message: content }, false);
             },
             info: (...args) => {
-                const content = args && args.length === 1 ? args[0] : args;
+                const content = args.length === 1 ? args[0] : args;
                 dreaction.send('log', { level: 'debug', message: content }, false);
             },
             logImportant: (...args) => {
-                const content = args && args.length === 1 ? args[0] : args;
+                const content = args.length === 1 ? args[0] : args;
                 dreaction.send('log', { level: 'debug', message: content }, true);
             },
             debug: (message, important = false) => dreaction.send('log', { level: 'debug', message }, !!important),
@@ -26,25 +27,6 @@ const logger = () => (dreaction) => {
     };
 };
 exports.default = logger;
-const hasLoggerPlugin = (dreaction) => {
-    return (dreaction &&
-        'log' in dreaction &&
-        typeof dreaction.log === 'function' &&
-        'info' in dreaction &&
-        typeof dreaction.info === 'function' &&
-        'logImportant' in dreaction &&
-        typeof dreaction.logImportant === 'function' &&
-        'debug' in dreaction &&
-        typeof dreaction.debug === 'function' &&
-        'warn' in dreaction &&
-        typeof dreaction.warn === 'function' &&
-        'error' in dreaction &&
-        typeof dreaction.error === 'function');
-};
-exports.hasLoggerPlugin = hasLoggerPlugin;
-const assertHasLoggerPlugin = (dreaction) => {
-    if (!(0, exports.hasLoggerPlugin)(dreaction)) {
-        throw new Error('This DReaction client has not had the logger plugin applied to it. Make sure that you add `use(logger())` before adding this plugin.');
-    }
-};
-exports.assertHasLoggerPlugin = assertHasLoggerPlugin;
+const loggerGuard = (0, plugin_guard_1.createPluginGuard)(['log', 'info', 'logImportant', 'debug', 'warn', 'error'], 'logger');
+exports.hasLoggerPlugin = loggerGuard.has;
+exports.assertHasLoggerPlugin = loggerGuard.assert;

package/lib/plugins/repl.d.ts

@@ -1,4 +1,4 @@
-import type { DReactionCore } from '../';
+import type { DReactionCore } from '../types';
 export type AcceptableRepls = object | Function | string | number;
 declare const repl: () => (dreaction: DReactionCore) => {
     onCommand: ({ type, payload }: import("dreaction-protocol").Command) => void;

package/lib/plugins/repl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repl.d.ts","sourceRoot":"","sources":["../../src/plugins/repl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAU,MAAM,KAAK,CAAC;AAGjD,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAElE,QAAA,MAAM,IAAI,oBAAqB,aAAa;;;qBA2CzB,MAAM,SAAS,eAAe;;CAahD,CAAC;AACF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"repl.d.ts","sourceRoot":"","sources":["../../src/plugins/repl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAU,MAAM,UAAU,CAAC;AAGtD,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAElE,QAAA,MAAM,IAAI,oBAAqB,aAAa;;;qBA2CzB,MAAM,SAAS,eAAe;;CAahD,CAAC;AACF,eAAe,IAAI,CAAC"}

package/lib/plugins/state-responses.d.ts

@@ -1,5 +1,5 @@
 import type { StateActionCompletePayload, StateBackupResponsePayload, StateKeysResponsePayload, StateValuesChangePayload, StateValuesResponsePayload } from 'dreaction-protocol';
-import type { DReactionCore, InferFeatures } from '../';
+import type { DReactionCore, InferFeatures } from '../types';
 /**
  * Provides helper functions for send state responses.
  */
@@ -9,12 +9,24 @@ declare const stateResponse: () => (dreaction: DReactionCore) => {
         stateValuesResponse: (path: StateValuesResponsePayload["path"], value: StateValuesResponsePayload["value"], valid?: StateValuesResponsePayload["value"]) => void;
         stateKeysResponse: (path: StateKeysResponsePayload["path"], keys: StateKeysResponsePayload["keys"], valid?: StateKeysResponsePayload["valid"]) => void;
         stateValuesChange: (changes: StateValuesChangePayload["changes"]) => false | void;
-        /** sends the state backup over to the server */
         stateBackupResponse: (state: StateBackupResponsePayload["state"]) => void;
     };
 };
-export type StateResponsePlugin = ReturnType<typeof stateResponse>;
 export default stateResponse;
-export declare const hasStateResponsePlugin: (dreaction: DReactionCore) => dreaction is DReactionCore & InferFeatures<DReactionCore, ReturnType<typeof stateResponse>>;
-export declare const assertHasStateResponsePlugin: (dreaction: DReactionCore) => asserts dreaction is DReactionCore & InferFeatures<DReactionCore, ReturnType<typeof stateResponse>>;
+export type StateResponsePlugin = ReturnType<typeof stateResponse>;
+export type StateResponseFeatures = InferFeatures<ReturnType<typeof stateResponse>>;
+export declare const hasStateResponsePlugin: (client: DReactionCore) => client is DReactionCore & {
+    stateActionComplete: (name: StateActionCompletePayload["name"], action: StateActionCompletePayload["action"], important?: any) => void;
+    stateValuesResponse: (path: StateValuesResponsePayload["path"], value: StateValuesResponsePayload["value"], valid?: StateValuesResponsePayload["value"]) => void;
+    stateKeysResponse: (path: StateKeysResponsePayload["path"], keys: StateKeysResponsePayload["keys"], valid?: StateKeysResponsePayload["valid"]) => void;
+    stateValuesChange: (changes: StateValuesChangePayload["changes"]) => false | void;
+    stateBackupResponse: (state: StateBackupResponsePayload["state"]) => void;
+};
+export declare const assertHasStateResponsePlugin: (client: DReactionCore) => asserts client is DReactionCore & {
+    stateActionComplete: (name: StateActionCompletePayload["name"], action: StateActionCompletePayload["action"], important?: any) => void;
+    stateValuesResponse: (path: StateValuesResponsePayload["path"], value: StateValuesResponsePayload["value"], valid?: StateValuesResponsePayload["value"]) => void;
+    stateKeysResponse: (path: StateKeysResponsePayload["path"], keys: StateKeysResponsePayload["keys"], valid?: StateKeysResponsePayload["valid"]) => void;
+    stateValuesChange: (changes: StateValuesChangePayload["changes"]) => false | void;
+    stateBackupResponse: (state: StateBackupResponsePayload["state"]) => void;
+};
 //# sourceMappingURL=state-responses.d.ts.map

package/lib/plugins/state-responses.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state-responses.d.ts","sourceRoot":"","sources":["../../src/plugins/state-responses.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,0BAA0B,EAC1B,0BAA0B,EAC1B,wBAAwB,EACxB,wBAAwB,EACxB,0BAA0B,EAC3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,aAAa,EAAU,aAAa,EAAE,MAAM,KAAK,CAAC;AAEhE;;GAEG;AACH,QAAA,MAAM,aAAa,oBAAqB,aAAa;;oCAIvC,0BAA0B,CAAC,MAAM,CAAC,UAChC,0BAA0B,CAAC,QAAQ,CAAC;oCAMtC,0BAA0B,CAAC,MAAM,CAAC,SACjC,0BAA0B,CAAC,OAAO,CAAC,UACnC,0BAA0B,CAAC,OAAO,CAAC;kCAIpC,wBAAwB,CAAC,MAAM,CAAC,QAChC,wBAAwB,CAAC,MAAM,CAAC,UAC/B,wBAAwB,CAAC,OAAO,CAAC;qCAGb,wBAAwB,CAAC,SAAS,CAAC;QAIhE,gDAAgD;qCACnB,0BAA0B,CAAC,OAAO,CAAC;;CAIrE,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AAEnE,eAAe,aAAa,CAAC;AAE7B,eAAO,MAAM,sBAAsB,cACtB,aAAa,KACvB,SAAS,IAAI,aAAa,GAC3B,aAAa,CAAC,aAAa,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAWV,CAAC;AAEtD,eAAO,MAAM,4BAA4B,cAC5B,aAAa,KACvB,QAAQ,SAAS,IAAI,aAAa,GACnC,aAAa,CAAC,aAAa,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAM9D,CAAC"}
+{"version":3,"file":"state-responses.d.ts","sourceRoot":"","sources":["../../src/plugins/state-responses.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,0BAA0B,EAC1B,0BAA0B,EAC1B,wBAAwB,EACxB,wBAAwB,EACxB,0BAA0B,EAC3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,aAAa,EAAU,aAAa,EAAE,MAAM,UAAU,CAAC;AAGrE;;GAEG;AACH,QAAA,MAAM,aAAa,oBAAqB,aAAa;;oCAIvC,0BAA0B,CAAC,MAAM,CAAC,UAChC,0BAA0B,CAAC,QAAQ,CAAC;oCAMtC,0BAA0B,CAAC,MAAM,CAAC,SACjC,0BAA0B,CAAC,OAAO,CAAC,UACnC,0BAA0B,CAAC,OAAO,CAAC;kCAIpC,wBAAwB,CAAC,MAAM,CAAC,QAChC,wBAAwB,CAAC,MAAM,CAAC,UAC/B,wBAAwB,CAAC,OAAO,CAAC;qCAGb,wBAAwB,CAAC,SAAS,CAAC;qCAInC,0BAA0B,CAAC,OAAO,CAAC;;CAIrE,CAAC;AAEF,eAAe,aAAa,CAAC;AAE7B,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACnE,MAAM,MAAM,qBAAqB,GAAG,aAAa,CAC/C,UAAU,CAAC,OAAO,aAAa,CAAC,CACjC,CAAC;AAaF,eAAO,MAAM,sBAAsB;gCA9CrB,0BAA0B,CAAC,MAAM,CAAC,UAChC,0BAA0B,CAAC,QAAQ,CAAC;gCAMtC,0BAA0B,CAAC,MAAM,CAAC,SACjC,0BAA0B,CAAC,OAAO,CAAC,UACnC,0BAA0B,CAAC,OAAO,CAAC;8BAIpC,wBAAwB,CAAC,MAAM,CAAC,QAChC,wBAAwB,CAAC,MAAM,CAAC,UAC/B,wBAAwB,CAAC,OAAO,CAAC;iCAGb,wBAAwB,CAAC,SAAS,CAAC;iCAInC,0BAA0B,CAAC,OAAO,CAAC;CAwBV,CAAC;AAC7D,eAAO,MAAM,4BAA4B;gCA/C3B,0BAA0B,CAAC,MAAM,CAAC,UAChC,0BAA0B,CAAC,QAAQ,CAAC;gCAMtC,0BAA0B,CAAC,MAAM,CAAC,SACjC,0BAA0B,CAAC,OAAO,CAAC,UACnC,0BAA0B,CAAC,OAAO,CAAC;8BAIpC,wBAAwB,CAAC,MAAM,CAAC,QAChC,wBAAwB,CAAC,MAAM,CAAC,UAC/B,wBAAwB,CAAC,OAAO,CAAC;iCAGb,wBAAwB,CAAC,SAAS,CAAC;iCAInC,0BAA0B,CAAC,OAAO,CAAC;CAyBD,CAAC"}

package/lib/plugins/state-responses.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.assertHasStateResponsePlugin = exports.hasStateResponsePlugin = void 0;
+const plugin_guard_1 = require("../utils/plugin-guard");
 /**
  * Provides helper functions for send state responses.
  */
@@ -12,27 +13,17 @@ const stateResponse = () => (dreaction) => {
             stateKeysResponse: (path, keys, valid = true) => dreaction.send('state.keys.response', { path, keys, valid }),
             stateValuesChange: (changes) => changes.length > 0 &&
                 dreaction.send('state.values.change', { changes }),
-            /** sends the state backup over to the server */
             stateBackupResponse: (state) => dreaction.send('state.backup.response', { state }),
         },
     };
 };
 exports.default = stateResponse;
-const hasStateResponsePlugin = (dreaction) => dreaction &&
-    'stateActionComplete' in dreaction &&
-    typeof dreaction.stateActionComplete === 'function' &&
-    'stateValuesResponse' in dreaction &&
-    typeof dreaction.stateValuesResponse === 'function' &&
-    'stateKeysResponse' in dreaction &&
-    typeof dreaction.stateKeysResponse === 'function' &&
-    'stateValuesChange' in dreaction &&
-    typeof dreaction.stateValuesChange === 'function' &&
-    'stateBackupResponse' in dreaction &&
-    typeof dreaction.stateBackupResponse === 'function';
-exports.hasStateResponsePlugin = hasStateResponsePlugin;
-const assertHasStateResponsePlugin = (dreaction) => {
-    if (!(0, exports.hasStateResponsePlugin)(dreaction)) {
-        throw new Error('This DReaction client has not had the state responses plugin applied to it. Make sure that you add `use(stateResponse())` before adding this plugin.');
-    }
-};
-exports.assertHasStateResponsePlugin = assertHasStateResponsePlugin;
+const stateResponseGuard = (0, plugin_guard_1.createPluginGuard)([
+    'stateActionComplete',
+    'stateValuesResponse',
+    'stateKeysResponse',
+    'stateValuesChange',
+    'stateBackupResponse',
+], 'state responses');
+exports.hasStateResponsePlugin = stateResponseGuard.has;
+exports.assertHasStateResponsePlugin = stateResponseGuard.assert;

package/lib/types.d.ts

@@ -0,0 +1,73 @@
+import type { Command, CommandMap, CustomCommandArg, CustomCommandRegisterPayload } from 'dreaction-protocol';
+import type { ClientOptions } from './client-options';
+type AnyFunction = (...args: any[]) => any;
+type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
+export interface DisplayConfig {
+    name: string;
+    value?: object | string | number | boolean | null | undefined;
+    preview?: string;
+    image?: string | {
+        uri: string;
+    };
+    important?: boolean;
+}
+interface ArgTypeMap {
+    string: string;
+}
+export type CustomCommandArgs<Args extends CustomCommandArg[]> = UnionToIntersection<Args extends Array<infer U> ? U extends CustomCommandArg ? {
+    [K in U as U['name']]: ArgTypeMap[U['type']];
+} : never : never>;
+export interface CustomCommand<Args extends CustomCommandArg[] = CustomCommandArg[]> extends Omit<CustomCommandRegisterPayload, 'id' | 'args'> {
+    id?: number;
+    handler: (args: CustomCommandArgs<Args>) => any | Promise<any>;
+    args?: Args;
+}
+export interface LifeCycleMethods {
+    onCommand?: (command: Command) => void;
+    onConnect?: () => void;
+    onDisconnect?: () => void;
+}
+export interface Plugin<Client> extends LifeCycleMethods {
+    features?: {
+        [key: string]: AnyFunction;
+    };
+    onPlugin?: (client: Client) => void;
+}
+export type PluginCreator<Client> = (client: Client) => Plugin<Client>;
+/**
+ * Extract features from a single PluginCreator
+ */
+type ExtractPluginFeatures<P> = P extends PluginCreator<any> ? ReturnType<P> extends {
+    features: infer F;
+} ? F : {} : {};
+/**
+ * Extract features type from a plugin or array of plugins.
+ * Supports:
+ * - Single PluginCreator: InferFeatures<typeof myPlugin>
+ * - Array of PluginCreators: InferFeatures<typeof plugins>
+ * - Legacy format: InferFeatures<Client, PluginCreator> (second param is the plugin)
+ */
+export type InferFeatures<ClientOrPlugin, LegacyPluginCreator = never> = [
+    LegacyPluginCreator
+] extends [never] ? ClientOrPlugin extends PluginCreator<any>[] ? UnionToIntersection<ExtractPluginFeatures<ClientOrPlugin[number]>> : ExtractPluginFeatures<ClientOrPlugin> : ExtractPluginFeatures<LegacyPluginCreator>;
+/**
+ * @deprecated Use InferFeatures instead
+ */
+export type InferFeaturesFromPlugins<_Client, Plugins extends PluginCreator<any>[]> = UnionToIntersection<ExtractPluginFeatures<Plugins[number]>>;
+export interface DReactionCore {
+    connected: boolean;
+    isReady: boolean;
+    options: ClientOptions<this>;
+    plugins: Plugin<this>[];
+    startTimer: () => () => number;
+    close: () => this;
+    send: <Type extends keyof CommandMap>(type: Type, payload?: CommandMap[Type], important?: boolean) => void;
+    display: (config: DisplayConfig) => void;
+    registerCustomCommand: <Args extends CustomCommandArg[] = Exclude<CustomCommand['args'], undefined>>(config: CustomCommand<Args>) => () => void | ((config: string, optHandler?: () => void) => () => void);
+    configure: (options?: ClientOptions<this>) => ClientOptions<this>['plugins'] extends PluginCreator<this>[] ? this & InferFeatures<ClientOptions<this>['plugins']> : this;
+    use: <P extends PluginCreator<this>>(pluginCreator: P) => this & InferFeatures<P>;
+    connect: () => this;
+    waitForConnect: () => Promise<void>;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/lib/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// #endregion

package/lib/utils/plugin-guard.d.ts

@@ -0,0 +1,12 @@
+import type { DReactionCore } from '../types';
+type AnyFunction = (...args: any[]) => any;
+/**
+ * Create type guard functions for plugin features.
+ * Reduces boilerplate for hasXxxPlugin and assertHasXxxPlugin patterns.
+ */
+export declare function createPluginGuard<T extends Record<string, AnyFunction>>(featureNames: (keyof T)[], pluginName: string): {
+    has: (client: DReactionCore) => client is DReactionCore & T;
+    assert: (client: DReactionCore) => asserts client is DReactionCore & T;
+};
+export {};
+//# sourceMappingURL=plugin-guard.d.ts.map

package/lib/utils/plugin-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-guard.d.ts","sourceRoot":"","sources":["../../src/utils/plugin-guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,KAAK,WAAW,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;AAE3C;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EACrE,YAAY,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,EACzB,UAAU,EAAE,MAAM;kBAEG,aAAa,KAAG,MAAM,IAAI,aAAa,GAAG,CAAC;qBAOtD,aAAa,KACpB,QAAQ,MAAM,IAAI,aAAa,GAAG,CAAC;EAUvC"}

package/lib/utils/plugin-guard.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPluginGuard = createPluginGuard;
+/**
+ * Create type guard functions for plugin features.
+ * Reduces boilerplate for hasXxxPlugin and assertHasXxxPlugin patterns.
+ */
+function createPluginGuard(featureNames, pluginName) {
+    const has = (client) => {
+        return featureNames.every((name) => name in client && typeof client[name] === 'function');
+    };
+    const assert = (client) => {
+        if (!has(client)) {
+            throw new Error(`This DReaction client has not had the ${pluginName} plugin applied to it. ` +
+                `Make sure that you add the plugin before using these features.`);
+        }
+    };
+    return { has, assert };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dreaction-client-core",
-  "version": "1.2.2",
+  "version": "1.4.0",
   "private": false,
   "description": "",
   "main": "lib/index.js",
@@ -17,7 +17,7 @@
     "@types/ws": "^8.5.13",
     "eventemitter-strict": "^1.0.1",
     "ws": "^8.18.0",
-    "dreaction-protocol": "1.0.9"
+    "dreaction-protocol": "1.0.11"
   },
   "devDependencies": {
     "typescript": "^5.4.5"