sonamu 0.9.5 → 0.9.7

package/dist/utils/utils.js

@@ -92,5 +92,5 @@ var init_utils = __esmMin((() => {}));
 
 //#endregion
 init_utils();
-export { assertDefined, assertExists, assertNotNull, convertFastifyHeadersToStandard, differenceWith, exhaustive, findApiRootPath, findAppRootPath, init_utils, intersectionBy, merge, nonNullable };
-//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXRpbHMuanMiLCJuYW1lcyI6W10sInNvdXJjZXMiOlsiLi4vLi4vc3JjL3V0aWxzL3V0aWxzLnRzIl0sInNvdXJjZXNDb250ZW50IjpbImltcG9ydCBmcyBmcm9tIFwiZnNcIjtcbmltcG9ydCBwYXRoIGZyb20gXCJwYXRoXCI7XG5cbmltcG9ydCB7IHR5cGUgRmFzdGlmeVJlcXVlc3QgfSBmcm9tIFwiZmFzdGlmeVwiO1xuXG5pbXBvcnQgeyB0eXBlIEFic29sdXRlUGF0aCB9IGZyb20gXCIuL3BhdGgtdXRpbHNcIjtcblxuZXhwb3J0IGZ1bmN0aW9uIGZpbmRBcHBSb290UGF0aCgpOiBBYnNvbHV0ZVBhdGgge1xuICBjb25zdCBhcGlSb290UGF0aCA9IGZpbmRBcGlSb290UGF0aCgpO1xuICByZXR1cm4gcGF0aC5kaXJuYW1lKGFwaVJvb3RQYXRoKSBhcyBBYnNvbHV0ZVBhdGg7XG59XG5cbmV4cG9ydCBmdW5jdGlvbiBmaW5kQXBpUm9vdFBhdGgoKTogQWJzb2x1dGVQYXRoIHtcbiAgLy8gTk9URTogZm9yIHN1cHBvcnQgbnBtIC8geWFybiAvIHBucG0gd29ya3NwYWNlc1xuICAvLyDtlZjsp4Drp4wgd29ya3NwYWNlIOyTsOuptCBwcm9jZXNzLmN3ZCgpIO2VmOuptCDrkJjripTrjbAuLi4g7J206rG0IOuCmOykkeyXkCDtmJHsnZgg7ZuEIOyImOygle2VmOuKlOqxuOuhnFxuICBjb25zdCB3b3Jrc3BhY2VQYXRoID0gcHJvY2Vzcy5lbnYuUE5QTV9TQ1JJUFRfU1JDX0RJUiA/PyBwcm9jZXNzLmVudi5JTklUX0NXRDtcbiAgaWYgKG5vbk51bGxhYmxlKHdvcmtzcGFjZVBhdGgpKSB7XG4gICAgcmV0dXJuIHdvcmtzcGFjZVBhdGggYXMgQWJzb2x1dGVQYXRoO1xuICB9XG5cbiAgaWYgKG5vbk51bGxhYmxlKHByb2Nlc3MuZW52LlBOUE1fUEFDS0FHRV9OQU1FKSkge1xuICAgIHJldHVybiBwcm9jZXNzLmN3ZCgpLnNwbGl0KHBhdGguc2VwKS5qb2luKHBhdGguc2VwKSBhcyBBYnNvbHV0ZVBhdGg7XG4gIH1cblxuICBjb25zdCBjd2RQYWNrYWdlUGF0aCA9IHBhdGguam9pbihwcm9jZXNzLmN3ZCgpLCBcInBhY2thZ2UuanNvblwiKTtcbiAgaWYgKGZzLmV4aXN0c1N5bmMoY3dkUGFja2FnZVBhdGgpKSB7XG4gICAgcmV0dXJuIHByb2Nlc3MuY3dkKCkuc3BsaXQocGF0aC5zZXApLmpvaW4ocGF0aC5zZXApIGFzIEFic29sdXRlUGF0aDtcbiAgfVxuXG4gIGNvbnN0IGJhc2VQYXRoID0gaW1wb3J0Lm1ldGEuZmlsZW5hbWU7XG4gIGxldCBkaXIgPSBwYXRoLmRpcm5hbWUoYmFzZVBhdGgpO1xuICBpZiAoZGlyLmluY2x1ZGVzKFwiLy55YXJuL1wiKSkge1xuICAgIGRpciA9IGRpci5zcGxpdChcIi8ueWFybi9cIilbMF07XG4gIH1cblxuICBkbyB7XG4gICAgaWYgKGZzLmV4aXN0c1N5bmMocGF0aC5qb2luKGRpciwgXCIvcGFja2FnZS5qc29uXCIpKSkge1xuICAgICAgcmV0dXJuIGRpci5zcGxpdChwYXRoLnNlcCkuam9pbihwYXRoLnNlcCkgYXMgQWJzb2x1dGVQYXRoO1xuICAgIH1cbiAgICBkaXIgPSBkaXIuc3BsaXQocGF0aC5zZXApLnNsaWNlKDAsIC0xKS5qb2luKHBhdGguc2VwKTtcbiAgfSB3aGlsZSAoZGlyLnNwbGl0KHBhdGguc2VwKS5sZW5ndGggPiAxKTtcbiAgdGhyb3cgbmV3IEVycm9yKFwiQ2Fubm90IGZpbmQgQXBwUm9vdCB1c2luZyBTb25hbXUgLTJcIik7XG59XG5cbmV4cG9ydCBmdW5jdGlvbiBub25OdWxsYWJsZTxUPih2YWx1ZTogVCk6IHZhbHVlIGlzIE5vbk51bGxhYmxlPFQ+IHtcbiAgcmV0dXJuIHZhbHVlICE9PSBudWxsICYmIHZhbHVlICE9PSB1bmRlZmluZWQ7XG59XG5cbmV4cG9ydCBmdW5jdGlvbiBleGhhdXN0aXZlKF9wYXJhbTogbmV2ZXIpIHtcbiAgdGhyb3cgbmV3IEVycm9yKGBleGhhdXN0aXZlYCk7XG59XG5cbi8vIOydvOuwmCDrsoTsoIRcbmV4cG9ydCBmdW5jdGlvbiBhc3NlcnRFeGlzdHM8VD4odmFsdWU6IFQgfCBudWxsIHwgdW5kZWZpbmVkLCBtZXNzYWdlPzogc3RyaW5nKTogVCB7XG4gIGlmICh2YWx1ZSA9PT0gbnVsbCB8fCB2YWx1ZSA9PT0gdW5kZWZpbmVkKSB7XG4gICAgdGhyb3cgbmV3IEVycm9yKG1lc3NhZ2UgPz8gXCJWYWx1ZSBtdXN0IGV4aXN0XCIpO1xuICB9XG4gIHJldHVybiB2YWx1ZTtcbn1cblxuLy8gbnVsbOunjCDssrTtgaxcbmV4cG9ydCBmdW5jdGlvbiBhc3NlcnROb3ROdWxsPFQ+KHZhbHVlOiBUIHwgbnVsbCwgbWVzc2FnZT86IHN0cmluZyk6IFQge1xuICBpZiAodmFsdWUgPT09IG51bGwpIHtcbiAgICB0aHJvdyBuZXcgRXJyb3IobWVzc2FnZSA/PyBcIlZhbHVlIG11c3Qgbm90IGJlIG51bGxcIik7XG4gIH1cbiAgcmV0dXJuIHZhbHVlO1xufVxuLy8gdW5kZWZpbmVk66eMIOyytO2BrFxuZXhwb3J0IGZ1bmN0aW9uIGFzc2VydERlZmluZWQ8VD4odmFsdWU6IFQgfCB1bmRlZmluZWQsIG1lc3NhZ2U/OiBzdHJpbmcpOiBUIHtcbiAgaWYgKHZhbHVlID09PSB1bmRlZmluZWQpIHtcbiAgICB0aHJvdyBuZXcgRXJyb3IobWVzc2FnZSA/PyBcIlZhbHVlIG11c3QgYmUgZGVmaW5lZFwiKTtcbiAgfVxuICByZXR1cm4gdmFsdWU7XG59XG5cbi8vIGxvZGFzaCBpbnRlcnNlY3Rpb25CeSDrjIDssrRcbmV4cG9ydCBmdW5jdGlvbiBpbnRlcnNlY3Rpb25CeTxULCBLPihcbiAgYXJyMTogcmVhZG9ubHkgVFtdLFxuICBhcnIyOiByZWFkb25seSBUW10sXG4gIGl0ZXJhdGVlOiAoaXRlbTogVCkgPT4gSyxcbik6IFRbXSB7XG4gIGNvbnN0IGFycjJLZXlzID0gbmV3IFNldChhcnIyLm1hcChpdGVyYXRlZSkpO1xuICByZXR1cm4gYXJyMS5maWx0ZXIoKGl0ZW0pID0+IGFycjJLZXlzLmhhcyhpdGVyYXRlZShpdGVtKSkpO1xufVxuLy8gbG9kYXNoIGRpZmZlcmVuY2VXaXRoIOuMgOyytFxuZXhwb3J0IGZ1bmN0aW9uIGRpZmZlcmVuY2VXaXRoPFQ+KFxuICBhcnIxOiByZWFkb25seSBUW10sXG4gIGFycjI6IHJlYWRvbmx5IFRbXSxcbiAgY29tcGFyYXRvcjogKGE6IFQsIGI6IFQpID0+IGJvb2xlYW4sXG4pOiBUW10ge1xuICByZXR1cm4gYXJyMS5maWx0ZXIoKGl0ZW1BKSA9PiAhYXJyMi5zb21lKChpdGVtQikgPT4gY29tcGFyYXRvcihpdGVtQSwgaXRlbUIpKSk7XG59XG5cbi8vIGJpb21lLWlnbm9yZSBsaW50L3N1c3BpY2lvdXMvbm9FeHBsaWNpdEFueTogZHluYW1pYyBwcm9wZXJ0eSBhY2Nlc3NcbmV4cG9ydCBmdW5jdGlvbiBtZXJnZTxUIGV4dGVuZHMgUmVjb3JkPHN0cmluZywgYW55Pj4oZGVmYXVsdE9iajogVCwgdXNlck9iajogVCk6IFQge1xuICAvLyDsm5Drs7gg67O07KG07J2EIOychO2VtCBkZWZhdWx0T2JqIOuzteyCrFxuICBjb25zdCByZXN1bHQgPSB7IC4uLmRlZmF1bHRPYmogfTtcblxuICAvLyB1c2VyT2Jq7J2YIOqwgSDsho3shLHsnYQg7Iic7ZqMXG4gIGZvciAoY29uc3Qga2V5IGluIHVzZXJPYmopIHtcbiAgICAvLyB1c2VyT2Jq7J2YIG93biBwcm9wZXJ0eeunjCDsspjrpqwgKO2UhOuhnO2GoO2DgOyehSDssrTsnbgg7KCc7Jm4KVxuICAgIGlmIChPYmplY3QuaGFzT3duKHVzZXJPYmosIGtleSkpIHtcbiAgICAgIGNvbnN0IHVzZXJWYWx1ZSA9IHVzZXJPYmpba2V5XTtcbiAgICAgIGNvbnN0IGRlZmF1bHRWYWx1ZSA9IHJlc3VsdFtrZXldO1xuXG4gICAgICAvLyDrkZAg6rCS7J20IOuqqOuRkCDqsJ3ssrTsnbTqs6AsIOuwsOyXtOydtCDslYTri4wg6rK97JqwIOyerOq3gOyggeycvOuhnCDrs5HtlalcbiAgICAgIGlmIChpc1BsYWluT2JqZWN0KHVzZXJWYWx1ZSkgJiYgaXNQbGFpbk9iamVjdChkZWZhdWx0VmFsdWUpKSB7XG4gICAgICAgIHJlc3VsdFtrZXldID0gbWVyZ2UoZGVmYXVsdFZhbHVlLCB1c2VyVmFsdWUpO1xuICAgICAgfSBlbHNlIHtcbiAgICAgICAgLy8g6re4IOyZuOydmCDqsr3smrAgdXNlck9iauydmCDqsJLsnLzroZwg642u7Ja07JOw6riwXG4gICAgICAgIHJlc3VsdFtrZXldID0gdXNlclZhbHVlO1xuICAgICAgfVxuICAgIH1cbiAgfVxuXG4gIHJldHVybiByZXN1bHQ7XG59XG5cbi8vIHBsYWluIG9iamVjdCDtjJDrs4Qg7Zes7Y28IO2VqOyImFxuLy8gKOuwsOyXtCwgbnVsbCwgRGF0ZSDrk7HsnYQg7KCc7Jm47ZWcIOyInOyImCDqsJ3ssrTrp4wgdHJ1ZSlcbmZ1bmN0aW9uIGlzUGxhaW5PYmplY3QodmFsdWU6IHVua25vd24pOiB2YWx1ZSBpcyBSZWNvcmQ8c3RyaW5nLCB1bmtub3duPiB7XG4gIHJldHVybiAoXG4gICAgdmFsdWUgIT09IG51bGwgJiZcbiAgICB0eXBlb2YgdmFsdWUgPT09IFwib2JqZWN0XCIgJiZcbiAgICAhQXJyYXkuaXNBcnJheSh2YWx1ZSkgJiZcbiAgICBPYmplY3QucHJvdG90eXBlLnRvU3RyaW5nLmNhbGwodmFsdWUpID09PSBcIltvYmplY3QgT2JqZWN0XVwiXG4gICk7XG59XG5cbi8vIENvbnZlcnQgRmFzdGlmeSBoZWFkZXJzIHRvIHN0YW5kYXJkIEhlYWRlcnMgb2JqZWN0XG5leHBvcnQgZnVuY3Rpb24gY29udmVydEZhc3RpZnlIZWFkZXJzVG9TdGFuZGFyZChoZWFkZXJzOiBGYXN0aWZ5UmVxdWVzdFtcImhlYWRlcnNcIl0pOiBIZWFkZXJzIHtcbiAgY29uc3QgaGVhZGVyc09iaiA9IG5ldyBIZWFkZXJzKCk7XG4gIE9iamVjdC5lbnRyaWVzKGhlYWRlcnMpLmZvckVhY2goKFtrZXksIHZhbHVlXSkgPT4ge1xuICAgIGlmICh2YWx1ZSkgaGVhZGVyc09iai5hcHBlbmQoa2V5LCB2YWx1ZS50b1N0cmluZygpKTtcbiAgfSk7XG4gIHJldHVybiBoZWFkZXJzT2JqO1xufVxuIl0sIm1hcHBpbmdzIjoiOzs7OztBQU9BLFNBQWdCLGtCQUFnQztDQUM5QyxNQUFNLGNBQWMsaUJBQWlCO0FBQ3JDLFFBQU8sS0FBSyxRQUFRLFlBQVk7O0FBR2xDLFNBQWdCLGtCQUFnQztDQUc5QyxNQUFNLGdCQUFnQixRQUFRLElBQUksdUJBQXVCLFFBQVEsSUFBSTtBQUNyRSxLQUFJLFlBQVksY0FBYyxFQUFFO0FBQzlCLFNBQU87O0FBR1QsS0FBSSxZQUFZLFFBQVEsSUFBSSxrQkFBa0IsRUFBRTtBQUM5QyxTQUFPLFFBQVEsS0FBSyxDQUFDLE1BQU0sS0FBSyxJQUFJLENBQUMsS0FBSyxLQUFLLElBQUk7O0NBR3JELE1BQU0saUJBQWlCLEtBQUssS0FBSyxRQUFRLEtBQUssRUFBRSxlQUFlO0FBQy9ELEtBQUksR0FBRyxXQUFXLGVBQWUsRUFBRTtBQUNqQyxTQUFPLFFBQVEsS0FBSyxDQUFDLE1BQU0sS0FBSyxJQUFJLENBQUMsS0FBSyxLQUFLLElBQUk7O0NBR3JELE1BQU0sV0FBVyxPQUFPLEtBQUs7Q0FDN0IsSUFBSSxNQUFNLEtBQUssUUFBUSxTQUFTO0FBQ2hDLEtBQUksSUFBSSxTQUFTLFVBQVUsRUFBRTtBQUMzQixRQUFNLElBQUksTUFBTSxVQUFVLENBQUM7O0FBRzdCLElBQUc7QUFDRCxNQUFJLEdBQUcsV0FBVyxLQUFLLEtBQUssS0FBSyxnQkFBZ0IsQ0FBQyxFQUFFO0FBQ2xELFVBQU8sSUFBSSxNQUFNLEtBQUssSUFBSSxDQUFDLEtBQUssS0FBSyxJQUFJOztBQUUzQyxRQUFNLElBQUksTUFBTSxLQUFLLElBQUksQ0FBQyxNQUFNLEdBQUcsQ0FBQyxFQUFFLENBQUMsS0FBSyxLQUFLLElBQUk7VUFDOUMsSUFBSSxNQUFNLEtBQUssSUFBSSxDQUFDLFNBQVM7QUFDdEMsT0FBTSxJQUFJLE1BQU0sc0NBQXNDOztBQUd4RCxTQUFnQixZQUFlLE9BQW1DO0FBQ2hFLFFBQU8sVUFBVSxRQUFRLFVBQVU7O0FBR3JDLFNBQWdCLFdBQVcsUUFBZTtBQUN4QyxPQUFNLElBQUksTUFBTSxhQUFhOztBQUkvQixTQUFnQixhQUFnQixPQUE2QixTQUFxQjtBQUNoRixLQUFJLFVBQVUsUUFBUSxVQUFVLFdBQVc7QUFDekMsUUFBTSxJQUFJLE1BQU0sV0FBVyxtQkFBbUI7O0FBRWhELFFBQU87O0FBSVQsU0FBZ0IsY0FBaUIsT0FBaUIsU0FBcUI7QUFDckUsS0FBSSxVQUFVLE1BQU07QUFDbEIsUUFBTSxJQUFJLE1BQU0sV0FBVyx5QkFBeUI7O0FBRXRELFFBQU87O0FBR1QsU0FBZ0IsY0FBaUIsT0FBc0IsU0FBcUI7QUFDMUUsS0FBSSxVQUFVLFdBQVc7QUFDdkIsUUFBTSxJQUFJLE1BQU0sV0FBVyx3QkFBd0I7O0FBRXJELFFBQU87O0FBSVQsU0FBZ0IsZUFDZCxNQUNBLE1BQ0EsVUFDSztDQUNMLE1BQU0sV0FBVyxJQUFJLElBQUksS0FBSyxJQUFJLFNBQVMsQ0FBQztBQUM1QyxRQUFPLEtBQUssUUFBUSxTQUFTLFNBQVMsSUFBSSxTQUFTLEtBQUssQ0FBQyxDQUFDOztBQUc1RCxTQUFnQixlQUNkLE1BQ0EsTUFDQSxZQUNLO0FBQ0wsUUFBTyxLQUFLLFFBQVEsVUFBVSxDQUFDLEtBQUssTUFBTSxVQUFVLFdBQVcsT0FBTyxNQUFNLENBQUMsQ0FBQzs7QUFJaEYsU0FBZ0IsTUFBcUMsWUFBZSxTQUFlO0NBRWpGLE1BQU0sU0FBUyxFQUFFLEdBQUcsWUFBWTtBQUdoQyxNQUFLLE1BQU0sT0FBTyxTQUFTO0FBRXpCLE1BQUksT0FBTyxPQUFPLFNBQVMsSUFBSSxFQUFFO0dBQy9CLE1BQU0sWUFBWSxRQUFRO0dBQzFCLE1BQU0sZUFBZSxPQUFPO0FBRzVCLE9BQUksY0FBYyxVQUFVLElBQUksY0FBYyxhQUFhLEVBQUU7QUFDM0QsV0FBTyxPQUFPLE1BQU0sY0FBYyxVQUFVO1VBQ3ZDO0FBRUwsV0FBTyxPQUFPOzs7O0FBS3BCLFFBQU87O0FBS1QsU0FBUyxjQUFjLE9BQWtEO0FBQ3ZFLFFBQ0UsVUFBVSxRQUNWLE9BQU8sVUFBVSxZQUNqQixDQUFDLE1BQU0sUUFBUSxNQUFNLElBQ3JCLE9BQU8sVUFBVSxTQUFTLEtBQUssTUFBTSxLQUFLOztBQUs5QyxTQUFnQixnQ0FBZ0MsU0FBNkM7Q0FDM0YsTUFBTSxhQUFhLElBQUksU0FBUztBQUNoQyxRQUFPLFFBQVEsUUFBUSxDQUFDLFNBQVMsQ0FBQyxLQUFLLFdBQVc7QUFDaEQsTUFBSSxNQUFPLFlBQVcsT0FBTyxLQUFLLE1BQU0sVUFBVSxDQUFDO0dBQ25EO0FBQ0YsUUFBTyJ9
+export { assertDefined, assertExists, assertNotNull, convertFastifyHeadersToStandard, differenceWith, exhaustive, findApiRootPath, findAppRootPath, init_utils, intersectionBy, isPlainObject, merge, nonNullable };
+//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXRpbHMuanMiLCJuYW1lcyI6W10sInNvdXJjZXMiOlsiLi4vLi4vc3JjL3V0aWxzL3V0aWxzLnRzIl0sInNvdXJjZXNDb250ZW50IjpbImltcG9ydCBmcyBmcm9tIFwiZnNcIjtcbmltcG9ydCBwYXRoIGZyb20gXCJwYXRoXCI7XG5cbmltcG9ydCB7IHR5cGUgRmFzdGlmeVJlcXVlc3QgfSBmcm9tIFwiZmFzdGlmeVwiO1xuXG5pbXBvcnQgeyB0eXBlIEFic29sdXRlUGF0aCB9IGZyb20gXCIuL3BhdGgtdXRpbHNcIjtcblxuZXhwb3J0IGZ1bmN0aW9uIGZpbmRBcHBSb290UGF0aCgpOiBBYnNvbHV0ZVBhdGgge1xuICBjb25zdCBhcGlSb290UGF0aCA9IGZpbmRBcGlSb290UGF0aCgpO1xuICByZXR1cm4gcGF0aC5kaXJuYW1lKGFwaVJvb3RQYXRoKSBhcyBBYnNvbHV0ZVBhdGg7XG59XG5cbmV4cG9ydCBmdW5jdGlvbiBmaW5kQXBpUm9vdFBhdGgoKTogQWJzb2x1dGVQYXRoIHtcbiAgLy8gTk9URTogZm9yIHN1cHBvcnQgbnBtIC8geWFybiAvIHBucG0gd29ya3NwYWNlc1xuICAvLyDtlZjsp4Drp4wgd29ya3NwYWNlIOyTsOuptCBwcm9jZXNzLmN3ZCgpIO2VmOuptCDrkJjripTrjbAuLi4g7J206rG0IOuCmOykkeyXkCDtmJHsnZgg7ZuEIOyImOygle2VmOuKlOqxuOuhnFxuICBjb25zdCB3b3Jrc3BhY2VQYXRoID0gcHJvY2Vzcy5lbnYuUE5QTV9TQ1JJUFRfU1JDX0RJUiA/PyBwcm9jZXNzLmVudi5JTklUX0NXRDtcbiAgaWYgKG5vbk51bGxhYmxlKHdvcmtzcGFjZVBhdGgpKSB7XG4gICAgcmV0dXJuIHdvcmtzcGFjZVBhdGggYXMgQWJzb2x1dGVQYXRoO1xuICB9XG5cbiAgaWYgKG5vbk51bGxhYmxlKHByb2Nlc3MuZW52LlBOUE1fUEFDS0FHRV9OQU1FKSkge1xuICAgIHJldHVybiBwcm9jZXNzLmN3ZCgpLnNwbGl0KHBhdGguc2VwKS5qb2luKHBhdGguc2VwKSBhcyBBYnNvbHV0ZVBhdGg7XG4gIH1cblxuICBjb25zdCBjd2RQYWNrYWdlUGF0aCA9IHBhdGguam9pbihwcm9jZXNzLmN3ZCgpLCBcInBhY2thZ2UuanNvblwiKTtcbiAgaWYgKGZzLmV4aXN0c1N5bmMoY3dkUGFja2FnZVBhdGgpKSB7XG4gICAgcmV0dXJuIHByb2Nlc3MuY3dkKCkuc3BsaXQocGF0aC5zZXApLmpvaW4ocGF0aC5zZXApIGFzIEFic29sdXRlUGF0aDtcbiAgfVxuXG4gIGNvbnN0IGJhc2VQYXRoID0gaW1wb3J0Lm1ldGEuZmlsZW5hbWU7XG4gIGxldCBkaXIgPSBwYXRoLmRpcm5hbWUoYmFzZVBhdGgpO1xuICBpZiAoZGlyLmluY2x1ZGVzKFwiLy55YXJuL1wiKSkge1xuICAgIGRpciA9IGRpci5zcGxpdChcIi8ueWFybi9cIilbMF07XG4gIH1cblxuICBkbyB7XG4gICAgaWYgKGZzLmV4aXN0c1N5bmMocGF0aC5qb2luKGRpciwgXCIvcGFja2FnZS5qc29uXCIpKSkge1xuICAgICAgcmV0dXJuIGRpci5zcGxpdChwYXRoLnNlcCkuam9pbihwYXRoLnNlcCkgYXMgQWJzb2x1dGVQYXRoO1xuICAgIH1cbiAgICBkaXIgPSBkaXIuc3BsaXQocGF0aC5zZXApLnNsaWNlKDAsIC0xKS5qb2luKHBhdGguc2VwKTtcbiAgfSB3aGlsZSAoZGlyLnNwbGl0KHBhdGguc2VwKS5sZW5ndGggPiAxKTtcbiAgdGhyb3cgbmV3IEVycm9yKFwiQ2Fubm90IGZpbmQgQXBwUm9vdCB1c2luZyBTb25hbXUgLTJcIik7XG59XG5cbmV4cG9ydCBmdW5jdGlvbiBub25OdWxsYWJsZTxUPih2YWx1ZTogVCk6IHZhbHVlIGlzIE5vbk51bGxhYmxlPFQ+IHtcbiAgcmV0dXJuIHZhbHVlICE9PSBudWxsICYmIHZhbHVlICE9PSB1bmRlZmluZWQ7XG59XG5cbmV4cG9ydCBmdW5jdGlvbiBleGhhdXN0aXZlKF9wYXJhbTogbmV2ZXIpIHtcbiAgdGhyb3cgbmV3IEVycm9yKGBleGhhdXN0aXZlYCk7XG59XG5cbi8vIOydvOuwmCDrsoTsoIRcbmV4cG9ydCBmdW5jdGlvbiBhc3NlcnRFeGlzdHM8VD4odmFsdWU6IFQgfCBudWxsIHwgdW5kZWZpbmVkLCBtZXNzYWdlPzogc3RyaW5nKTogVCB7XG4gIGlmICh2YWx1ZSA9PT0gbnVsbCB8fCB2YWx1ZSA9PT0gdW5kZWZpbmVkKSB7XG4gICAgdGhyb3cgbmV3IEVycm9yKG1lc3NhZ2UgPz8gXCJWYWx1ZSBtdXN0IGV4aXN0XCIpO1xuICB9XG4gIHJldHVybiB2YWx1ZTtcbn1cblxuLy8gbnVsbOunjCDssrTtgaxcbmV4cG9ydCBmdW5jdGlvbiBhc3NlcnROb3ROdWxsPFQ+KHZhbHVlOiBUIHwgbnVsbCwgbWVzc2FnZT86IHN0cmluZyk6IFQge1xuICBpZiAodmFsdWUgPT09IG51bGwpIHtcbiAgICB0aHJvdyBuZXcgRXJyb3IobWVzc2FnZSA/PyBcIlZhbHVlIG11c3Qgbm90IGJlIG51bGxcIik7XG4gIH1cbiAgcmV0dXJuIHZhbHVlO1xufVxuLy8gdW5kZWZpbmVk66eMIOyytO2BrFxuZXhwb3J0IGZ1bmN0aW9uIGFzc2VydERlZmluZWQ8VD4odmFsdWU6IFQgfCB1bmRlZmluZWQsIG1lc3NhZ2U/OiBzdHJpbmcpOiBUIHtcbiAgaWYgKHZhbHVlID09PSB1bmRlZmluZWQpIHtcbiAgICB0aHJvdyBuZXcgRXJyb3IobWVzc2FnZSA/PyBcIlZhbHVlIG11c3QgYmUgZGVmaW5lZFwiKTtcbiAgfVxuICByZXR1cm4gdmFsdWU7XG59XG5cbi8vIGxvZGFzaCBpbnRlcnNlY3Rpb25CeSDrjIDssrRcbmV4cG9ydCBmdW5jdGlvbiBpbnRlcnNlY3Rpb25CeTxULCBLPihcbiAgYXJyMTogcmVhZG9ubHkgVFtdLFxuICBhcnIyOiByZWFkb25seSBUW10sXG4gIGl0ZXJhdGVlOiAoaXRlbTogVCkgPT4gSyxcbik6IFRbXSB7XG4gIGNvbnN0IGFycjJLZXlzID0gbmV3IFNldChhcnIyLm1hcChpdGVyYXRlZSkpO1xuICByZXR1cm4gYXJyMS5maWx0ZXIoKGl0ZW0pID0+IGFycjJLZXlzLmhhcyhpdGVyYXRlZShpdGVtKSkpO1xufVxuLy8gbG9kYXNoIGRpZmZlcmVuY2VXaXRoIOuMgOyytFxuZXhwb3J0IGZ1bmN0aW9uIGRpZmZlcmVuY2VXaXRoPFQ+KFxuICBhcnIxOiByZWFkb25seSBUW10sXG4gIGFycjI6IHJlYWRvbmx5IFRbXSxcbiAgY29tcGFyYXRvcjogKGE6IFQsIGI6IFQpID0+IGJvb2xlYW4sXG4pOiBUW10ge1xuICByZXR1cm4gYXJyMS5maWx0ZXIoKGl0ZW1BKSA9PiAhYXJyMi5zb21lKChpdGVtQikgPT4gY29tcGFyYXRvcihpdGVtQSwgaXRlbUIpKSk7XG59XG5cbi8vIGJpb21lLWlnbm9yZSBsaW50L3N1c3BpY2lvdXMvbm9FeHBsaWNpdEFueTogZHluYW1pYyBwcm9wZXJ0eSBhY2Nlc3NcbmV4cG9ydCBmdW5jdGlvbiBtZXJnZTxUIGV4dGVuZHMgUmVjb3JkPHN0cmluZywgYW55Pj4oZGVmYXVsdE9iajogVCwgdXNlck9iajogVCk6IFQge1xuICAvLyDsm5Drs7gg67O07KG07J2EIOychO2VtCBkZWZhdWx0T2JqIOuzteyCrFxuICBjb25zdCByZXN1bHQgPSB7IC4uLmRlZmF1bHRPYmogfTtcblxuICAvLyB1c2VyT2Jq7J2YIOqwgSDsho3shLHsnYQg7Iic7ZqMXG4gIGZvciAoY29uc3Qga2V5IGluIHVzZXJPYmopIHtcbiAgICAvLyB1c2VyT2Jq7J2YIG93biBwcm9wZXJ0eeunjCDsspjrpqwgKO2UhOuhnO2GoO2DgOyehSDssrTsnbgg7KCc7Jm4KVxuICAgIGlmIChPYmplY3QuaGFzT3duKHVzZXJPYmosIGtleSkpIHtcbiAgICAgIGNvbnN0IHVzZXJWYWx1ZSA9IHVzZXJPYmpba2V5XTtcbiAgICAgIGNvbnN0IGRlZmF1bHRWYWx1ZSA9IHJlc3VsdFtrZXldO1xuXG4gICAgICAvLyDrkZAg6rCS7J20IOuqqOuRkCDqsJ3ssrTsnbTqs6AsIOuwsOyXtOydtCDslYTri4wg6rK97JqwIOyerOq3gOyggeycvOuhnCDrs5HtlalcbiAgICAgIGlmIChpc1BsYWluT2JqZWN0KHVzZXJWYWx1ZSkgJiYgaXNQbGFpbk9iamVjdChkZWZhdWx0VmFsdWUpKSB7XG4gICAgICAgIHJlc3VsdFtrZXldID0gbWVyZ2UoZGVmYXVsdFZhbHVlLCB1c2VyVmFsdWUpO1xuICAgICAgfSBlbHNlIHtcbiAgICAgICAgLy8g6re4IOyZuOydmCDqsr3smrAgdXNlck9iauydmCDqsJLsnLzroZwg642u7Ja07JOw6riwXG4gICAgICAgIHJlc3VsdFtrZXldID0gdXNlclZhbHVlO1xuICAgICAgfVxuICAgIH1cbiAgfVxuXG4gIHJldHVybiByZXN1bHQ7XG59XG5cbi8vIHBsYWluIG9iamVjdCDtjJDrs4Qg7Zes7Y28IO2VqOyImFxuLy8gKOuwsOyXtCwgbnVsbCwgRGF0ZSDrk7HsnYQg7KCc7Jm47ZWcIOyInOyImCDqsJ3ssrTrp4wgdHJ1ZSlcbmV4cG9ydCBmdW5jdGlvbiBpc1BsYWluT2JqZWN0KHZhbHVlOiB1bmtub3duKTogdmFsdWUgaXMgUmVjb3JkPHN0cmluZywgdW5rbm93bj4ge1xuICByZXR1cm4gKFxuICAgIHZhbHVlICE9PSBudWxsICYmXG4gICAgdHlwZW9mIHZhbHVlID09PSBcIm9iamVjdFwiICYmXG4gICAgIUFycmF5LmlzQXJyYXkodmFsdWUpICYmXG4gICAgT2JqZWN0LnByb3RvdHlwZS50b1N0cmluZy5jYWxsKHZhbHVlKSA9PT0gXCJbb2JqZWN0IE9iamVjdF1cIlxuICApO1xufVxuXG4vLyBDb252ZXJ0IEZhc3RpZnkgaGVhZGVycyB0byBzdGFuZGFyZCBIZWFkZXJzIG9iamVjdFxuZXhwb3J0IGZ1bmN0aW9uIGNvbnZlcnRGYXN0aWZ5SGVhZGVyc1RvU3RhbmRhcmQoaGVhZGVyczogRmFzdGlmeVJlcXVlc3RbXCJoZWFkZXJzXCJdKTogSGVhZGVycyB7XG4gIGNvbnN0IGhlYWRlcnNPYmogPSBuZXcgSGVhZGVycygpO1xuICBPYmplY3QuZW50cmllcyhoZWFkZXJzKS5mb3JFYWNoKChba2V5LCB2YWx1ZV0pID0+IHtcbiAgICBpZiAodmFsdWUpIGhlYWRlcnNPYmouYXBwZW5kKGtleSwgdmFsdWUudG9TdHJpbmcoKSk7XG4gIH0pO1xuICByZXR1cm4gaGVhZGVyc09iajtcbn1cbiJdLCJtYXBwaW5ncyI6Ijs7Ozs7QUFPQSxTQUFnQixrQkFBZ0M7Q0FDOUMsTUFBTSxjQUFjLGlCQUFpQjtBQUNyQyxRQUFPLEtBQUssUUFBUSxZQUFZOztBQUdsQyxTQUFnQixrQkFBZ0M7Q0FHOUMsTUFBTSxnQkFBZ0IsUUFBUSxJQUFJLHVCQUF1QixRQUFRLElBQUk7QUFDckUsS0FBSSxZQUFZLGNBQWMsRUFBRTtBQUM5QixTQUFPOztBQUdULEtBQUksWUFBWSxRQUFRLElBQUksa0JBQWtCLEVBQUU7QUFDOUMsU0FBTyxRQUFRLEtBQUssQ0FBQyxNQUFNLEtBQUssSUFBSSxDQUFDLEtBQUssS0FBSyxJQUFJOztDQUdyRCxNQUFNLGlCQUFpQixLQUFLLEtBQUssUUFBUSxLQUFLLEVBQUUsZUFBZTtBQUMvRCxLQUFJLEdBQUcsV0FBVyxlQUFlLEVBQUU7QUFDakMsU0FBTyxRQUFRLEtBQUssQ0FBQyxNQUFNLEtBQUssSUFBSSxDQUFDLEtBQUssS0FBSyxJQUFJOztDQUdyRCxNQUFNLFdBQVcsT0FBTyxLQUFLO0NBQzdCLElBQUksTUFBTSxLQUFLLFFBQVEsU0FBUztBQUNoQyxLQUFJLElBQUksU0FBUyxVQUFVLEVBQUU7QUFDM0IsUUFBTSxJQUFJLE1BQU0sVUFBVSxDQUFDOztBQUc3QixJQUFHO0FBQ0QsTUFBSSxHQUFHLFdBQVcsS0FBSyxLQUFLLEtBQUssZ0JBQWdCLENBQUMsRUFBRTtBQUNsRCxVQUFPLElBQUksTUFBTSxLQUFLLElBQUksQ0FBQyxLQUFLLEtBQUssSUFBSTs7QUFFM0MsUUFBTSxJQUFJLE1BQU0sS0FBSyxJQUFJLENBQUMsTUFBTSxHQUFHLENBQUMsRUFBRSxDQUFDLEtBQUssS0FBSyxJQUFJO1VBQzlDLElBQUksTUFBTSxLQUFLLElBQUksQ0FBQyxTQUFTO0FBQ3RDLE9BQU0sSUFBSSxNQUFNLHNDQUFzQzs7QUFHeEQsU0FBZ0IsWUFBZSxPQUFtQztBQUNoRSxRQUFPLFVBQVUsUUFBUSxVQUFVOztBQUdyQyxTQUFnQixXQUFXLFFBQWU7QUFDeEMsT0FBTSxJQUFJLE1BQU0sYUFBYTs7QUFJL0IsU0FBZ0IsYUFBZ0IsT0FBNkIsU0FBcUI7QUFDaEYsS0FBSSxVQUFVLFFBQVEsVUFBVSxXQUFXO0FBQ3pDLFFBQU0sSUFBSSxNQUFNLFdBQVcsbUJBQW1COztBQUVoRCxRQUFPOztBQUlULFNBQWdCLGNBQWlCLE9BQWlCLFNBQXFCO0FBQ3JFLEtBQUksVUFBVSxNQUFNO0FBQ2xCLFFBQU0sSUFBSSxNQUFNLFdBQVcseUJBQXlCOztBQUV0RCxRQUFPOztBQUdULFNBQWdCLGNBQWlCLE9BQXNCLFNBQXFCO0FBQzFFLEtBQUksVUFBVSxXQUFXO0FBQ3ZCLFFBQU0sSUFBSSxNQUFNLFdBQVcsd0JBQXdCOztBQUVyRCxRQUFPOztBQUlULFNBQWdCLGVBQ2QsTUFDQSxNQUNBLFVBQ0s7Q0FDTCxNQUFNLFdBQVcsSUFBSSxJQUFJLEtBQUssSUFBSSxTQUFTLENBQUM7QUFDNUMsUUFBTyxLQUFLLFFBQVEsU0FBUyxTQUFTLElBQUksU0FBUyxLQUFLLENBQUMsQ0FBQzs7QUFHNUQsU0FBZ0IsZUFDZCxNQUNBLE1BQ0EsWUFDSztBQUNMLFFBQU8sS0FBSyxRQUFRLFVBQVUsQ0FBQyxLQUFLLE1BQU0sVUFBVSxXQUFXLE9BQU8sTUFBTSxDQUFDLENBQUM7O0FBSWhGLFNBQWdCLE1BQXFDLFlBQWUsU0FBZTtDQUVqRixNQUFNLFNBQVMsRUFBRSxHQUFHLFlBQVk7QUFHaEMsTUFBSyxNQUFNLE9BQU8sU0FBUztBQUV6QixNQUFJLE9BQU8sT0FBTyxTQUFTLElBQUksRUFBRTtHQUMvQixNQUFNLFlBQVksUUFBUTtHQUMxQixNQUFNLGVBQWUsT0FBTztBQUc1QixPQUFJLGNBQWMsVUFBVSxJQUFJLGNBQWMsYUFBYSxFQUFFO0FBQzNELFdBQU8sT0FBTyxNQUFNLGNBQWMsVUFBVTtVQUN2QztBQUVMLFdBQU8sT0FBTzs7OztBQUtwQixRQUFPOztBQUtULFNBQWdCLGNBQWMsT0FBa0Q7QUFDOUUsUUFDRSxVQUFVLFFBQ1YsT0FBTyxVQUFVLFlBQ2pCLENBQUMsTUFBTSxRQUFRLE1BQU0sSUFDckIsT0FBTyxVQUFVLFNBQVMsS0FBSyxNQUFNLEtBQUs7O0FBSzlDLFNBQWdCLGdDQUFnQyxTQUE2QztDQUMzRixNQUFNLGFBQWEsSUFBSSxTQUFTO0FBQ2hDLFFBQU8sUUFBUSxRQUFRLENBQUMsU0FBUyxDQUFDLEtBQUssV0FBVztBQUNoRCxNQUFJLE1BQU8sWUFBVyxPQUFPLEtBQUssTUFBTSxVQUFVLENBQUM7R0FDbkQ7QUFDRixRQUFPIn0=

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sonamu",
-  "version": "0.9.5",
+  "version": "0.9.7",
   "description": "Sonamu — TypeScript Fullstack API Framework",
   "keywords": [
     "framework",
@@ -95,11 +95,13 @@
     "@fastify/multipart": "^8",
     "@fastify/passport": "^2.2.0",
     "@fastify/static": "^7",
+    "@fastify/websocket": "^8.3.0",
     "@logtape/fastify": "2.0.0",
     "@logtape/logtape": "2.0.0",
     "@logtape/pretty": "2.0.0",
     "@logtape/redaction": "2.0.0",
     "@sheetkit/node": "^0.5.0",
+    "@types/ws": "^8.18.1",
     "bcrypt": "^6.0.0",
     "bentocache": "^1.5.0",
     "better-auth": "~1.6.0",

package/src/api/__tests__/sonamu.websocket.test.ts

@@ -0,0 +1,64 @@
+import { describe, expect, it } from "vitest";
+
+import { type AnyWebSocketConnection } from "../../stream/ws";
+import { type WebSocketContext } from "../context";
+import { Sonamu } from "../sonamu";
+
+describe("Sonamu websocket context scoping", () => {
+  it("restores websocket context inside deferred message handlers", async () => {
+    const messageHandlers = new Map<string, (data: unknown) => void | Promise<void>>();
+
+    const rawWs = {
+      id: "ws-1",
+      namespace: "chat",
+      transport: "ws" as const,
+      closed: false,
+      publishUntyped() {},
+      close() {},
+      onClose() {},
+      onMessage(event, handler) {
+        messageHandlers.set(String(event), handler as (data: unknown) => void | Promise<void>);
+      },
+      publish() {},
+      waitForClose() {
+        return Promise.resolve();
+      },
+      join() {},
+      leave() {},
+      setUserId() {},
+      clearUserId() {},
+    } satisfies AnyWebSocketConnection;
+
+    let context: WebSocketContext | null = null;
+    const scopedWs = (
+      Sonamu as unknown as {
+        createScopedWebSocketConnection(
+          ws: AnyWebSocketConnection,
+          getContext: () => WebSocketContext | null,
+        ): AnyWebSocketConnection;
+      }
+    ).createScopedWebSocketConnection(rawWs, () => context);
+
+    context = {
+      transport: "ws",
+      request: {} as WebSocketContext["request"],
+      headers: {},
+      ws: scopedWs,
+      naiteStore: new Map(),
+      locale: "ko",
+      user: null,
+      session: null,
+    };
+
+    let seenTransport: WebSocketContext["transport"] | null = null;
+    scopedWs.onMessage("joinRoom", async () => {
+      seenTransport = Sonamu.getContext<WebSocketContext>().transport;
+    });
+
+    await messageHandlers.get("joinRoom")?.({
+      roomId: "room-1",
+    });
+
+    expect(seenTransport).toBe("ws");
+  });
+});

package/src/api/__tests__/websocket-context.types.test.ts

@@ -0,0 +1,58 @@
+import { describe, expectTypeOf, it } from "vitest";
+
+import { type WebSocketContext } from "../context";
+
+type ChatOutEvents = {
+  ready: {
+    history: string[];
+  };
+  typingUsers: Array<{
+    id: string;
+    name: string;
+  }>;
+};
+
+type ChatInEvents = {
+  sendMessage: {
+    content: string;
+  };
+  typing: {
+    active: boolean;
+  };
+};
+
+function assertTypedWebSocketContext(ctx: WebSocketContext<ChatOutEvents, ChatInEvents>) {
+  ctx.ws.onMessage("sendMessage", (data) => {
+    expectTypeOf(data).toEqualTypeOf<{ content: string }>();
+    expectTypeOf(data.content).toEqualTypeOf<string>();
+  });
+
+  ctx.ws.onMessage("typing", (data) => {
+    expectTypeOf(data).toEqualTypeOf<{ active: boolean }>();
+    expectTypeOf(data.active).toEqualTypeOf<boolean>();
+  });
+
+  ctx.ws.publish("ready", { history: ["hello"] });
+  ctx.ws.publish("typingUsers", [{ id: "u1", name: "Kim" }]);
+
+  // @ts-expect-error invalid inbound event name
+  ctx.ws.onMessage("unknown", () => {});
+  // @ts-expect-error invalid outbound payload
+  ctx.ws.publish("ready", { nope: true });
+}
+
+function assertDefaultWebSocketContext(ctx: WebSocketContext) {
+  ctx.ws.onMessage("sendMessage", (data) => {
+    expectTypeOf(data).toEqualTypeOf<unknown>();
+  });
+}
+
+describe("WebSocketContext typing", () => {
+  it("narrows ws handlers and publish payloads from generic event maps", () => {
+    expectTypeOf(assertTypedWebSocketContext).toBeFunction();
+  });
+
+  it("defaults handler payloads to unknown when generics are omitted", () => {
+    expectTypeOf(assertDefaultWebSocketContext).toBeFunction();
+  });
+});

package/src/api/config.ts

@@ -3,6 +3,7 @@ import { type FastifyCorsOptions } from "@fastify/cors";
 import { type FastifyFormbodyOptions } from "@fastify/formbody";
 import { type FastifyMultipartOptions } from "@fastify/multipart";
 import { type FastifyStaticOptions } from "@fastify/static";
+import { type WebsocketPluginOptions } from "@fastify/websocket";
 import { type BetterAuthOptions } from "better-auth";
 import {
   type FastifyInstance,
@@ -18,9 +19,10 @@ import { type CacheConfig } from "../cache/types";
 import { type SonamuDBConfig } from "../database/db";
 import { type SonamuLoggingOptions } from "../logger/configure";
 import { type StorageConfig } from "../storage/types";
+import { type WebSocketRuntimeOptions } from "../stream/ws";
 import { type WorkflowOptions } from "../tasks/workflow-manager";
 import { type Executable, type SonamuFastifyConfig } from "../types/types";
-import { type Context } from "./context";
+import { type Context, type WebSocketContext } from "./context";
 
 export type DatabaseConfig = Omit<Knex.Config, "connection"> & {
   connection?: Knex.PgConnectionConfig;
@@ -180,6 +182,7 @@ export type SonamuServerOptions = {
     qs?: boolean | QsPluginOptions;
     sse?: boolean | SsePluginOptions;
     static?: boolean | FastifyStaticOptions;
+    ws?: boolean | WebsocketPluginOptions;
 
     custom?: (server: FastifyInstance) => void;
   };
@@ -200,6 +203,14 @@ export type SonamuServerOptions = {
     };
   };
 
+  /**
+   * WebSocket runtime 설정.
+   *
+   * 단일 인스턴스에서는 기본값으로 충분하며, 멀티 인스턴스/대규모 환경에서는
+   * presence store와 cluster bus를 여기서 주입합니다.
+   */
+  websocket?: WebSocketRuntimeOptions;
+
   apiConfig: SonamuFastifyConfig;
 
   /**
@@ -255,9 +266,24 @@ export type SonamuTaskOptions = {
   contextProvider: (
     defaultContext: Pick<
       Context,
-      "reply" | "request" | "headers" | "createSSE" | "naiteStore" | "locale" | "user" | "session"
+      | "transport"
+      | "reply"
+      | "request"
+      | "headers"
+      | "createSSE"
+      | "naiteStore"
+      | "locale"
+      | "user"
+      | "session"
     >,
   ) => Context | Promise<Context>;
+  websocketContextProvider?: (
+    defaultContext: Pick<
+      WebSocketContext,
+      "transport" | "request" | "headers" | "ws" | "naiteStore" | "locale" | "user" | "session"
+    >,
+    request: FastifyRequest,
+  ) => WebSocketContext | Promise<WebSocketContext>;
 };
 
 export type SonamuSSROptions = {

package/src/api/context.ts

@@ -14,24 +14,38 @@ import { type NaiteStore } from "../naite/naite";
 import { type BufferedFile } from "../storage/buffered-file";
 import { type UploadedFile } from "../storage/uploaded-file";
 import { type createSSEFactory } from "../stream/sse";
+import { type WebSocketConnection, type WebSocketEventMap } from "../stream/ws";
 
 // oxlint-disable-next-line @typescript-eslint/no-empty-interface -- Context 확장 타입
 export interface ContextExtend {}
-export type Context = {
+type BaseContext = {
   request: FastifyRequest;
-  reply: FastifyReply<Server, IncomingMessage, ServerResponse, RouteGenericInterface>;
   headers: IncomingHttpHeaders;
-  createSSE: <T extends ZodObject>(events: T) => ReturnType<typeof createSSEFactory<T>>;
   naiteStore: NaiteStore;
   /** 현재 요청의 locale */
   locale: string;
+  /** 현재 로그인한 사용자 (null이면 미인증) */
+  user: User | null;
+  /** 현재 세션 정보 (null이면 미인증) */
+  session: Session | null;
+};
+
+export type Context = BaseContext & {
+  transport: "http";
+  reply: FastifyReply<Server, IncomingMessage, ServerResponse, RouteGenericInterface>;
+  createSSE: <T extends ZodObject>(events: T) => ReturnType<typeof createSSEFactory<T>>;
   /** buffer 모드에서 업로드된 파일 */
   bufferedFiles?: BufferedFile[];
   /** stream 모드에서 업로드된 파일 */
   uploadedFiles?: UploadedFile[];
+} & ContextExtend;
 
-  /** 현재 로그인한 사용자 (null이면 미인증) */
-  user: User | null;
-  /** 현재 세션 정보 (null이면 미인증) */
-  session: Session | null;
+export type WebSocketContext<
+  TOut extends WebSocketEventMap = WebSocketEventMap,
+  TIn extends WebSocketEventMap = WebSocketEventMap,
+> = BaseContext & {
+  transport: "ws";
+  ws: WebSocketConnection<TOut, TIn>;
 } & ContextExtend;
+
+export type RuntimeContext = Context | WebSocketContext;

package/src/api/decorators.ts

@@ -53,7 +53,7 @@ export type ApiDecoratorOptions = {
   compress?: CompressConfig;
 };
 export type StreamDecoratorOptions = {
-  type: "sse"; // | 'ws
+  type: "sse";
   // oxlint-disable-next-line @typescript-eslint/no-explicit-any -- 이벤트 키별로 넘겨주는 값이므로 어떤 타입이든 상관없음
   events: z.ZodObject<any>;
   path?: string;
@@ -61,6 +61,24 @@ export type StreamDecoratorOptions = {
   guards?: GuardKey[];
   description?: string;
 };
+export type WebSocketDecoratorOptions = {
+  // oxlint-disable-next-line @typescript-eslint/no-explicit-any -- 이벤트 키별로 넘겨주는 값이므로 어떤 타입이든 상관없음
+  outEvents: z.ZodObject<any>;
+  // oxlint-disable-next-line @typescript-eslint/no-explicit-any -- 이벤트 키별로 넘겨주는 값이므로 어떤 타입이든 상관없음
+  inEvents: z.ZodObject<any>;
+  path?: string;
+  resourceName?: string;
+  guards?: GuardKey[];
+  description?: string;
+  heartbeat?: number;
+  maxPayload?: number;
+  namespace?: string;
+};
+export type ResolvedWebSocketDecoratorOptions = WebSocketDecoratorOptions & {
+  // codegen이 타입 이름을 재사용할 수 있도록 syncer가 AST에서 보강하는 메타데이터
+  outEventsTypeRef?: ApiParamType.Ref;
+  inEventsTypeRef?: ApiParamType.Ref;
+};
 
 type BufferUploadOptions = {
   consume?: "buffer";
@@ -85,6 +103,7 @@ export const registeredApis: {
   path: string;
   options: ApiDecoratorOptions;
   streamOptions?: StreamDecoratorOptions;
+  websocketOptions?: ResolvedWebSocketDecoratorOptions;
   uploadOptions?: UploadDecoratorOptions;
 }[] = [];
 export type ExtendedApi = {
@@ -93,6 +112,7 @@ export type ExtendedApi = {
   path: string;
   options: ApiDecoratorOptions;
   streamOptions?: StreamDecoratorOptions;
+  websocketOptions?: ResolvedWebSocketDecoratorOptions;
   uploadOptions?: UploadDecoratorOptions;
   typeParameters: ApiParamType.TypeParam[];
   parameters: ApiParam[];
@@ -103,6 +123,7 @@ type DecoratorTarget = { constructor: { name: string } };
 const DECORATOR_TYPES = {
   API: Symbol("api"),
   STREAM: Symbol("stream"),
+  WEBSOCKET: Symbol("websocket"),
   UPLOAD: Symbol("upload"),
 } as const;
 
@@ -110,7 +131,7 @@ function checkSingleDecorator(target: DecoratorTarget, propertyKey: string, deco
   const method = target[propertyKey as keyof typeof target] as { __decoratorType?: symbol };
   if (method?.__decoratorType && method?.__decoratorType !== decoratorType) {
     throw new Error(
-      `@${decoratorType.description ?? String(decoratorType)} decorator can only be used once on ${target.constructor.name}.${propertyKey}. You can use only one of @api or @stream decorator on the same method.`,
+      `@${decoratorType.description ?? String(decoratorType)} decorator can only be used once on ${target.constructor.name}.${propertyKey}. You can use only one of @api, @stream, @websocket, or @upload decorator on the same method.`,
     );
   } else {
     method.__decoratorType = decoratorType;
@@ -278,6 +299,85 @@ export function stream(options: StreamDecoratorOptions) {
   };
 }
 
+export function websocket(options: WebSocketDecoratorOptions) {
+  return (target: DecoratorTarget, propertyKey: string, descriptor: PropertyDescriptor) => {
+    const modelName = target.constructor.name.match(/(.+)Class$/)?.[1];
+    assert(
+      modelName,
+      `modelName is required on @websocket decorator on ${target.constructor.name}.${propertyKey}`,
+    );
+    const methodName = propertyKey;
+
+    checkSingleDecorator(target, propertyKey, DECORATOR_TYPES.WEBSOCKET);
+
+    const defaultPath = `/${inflection.camelize(
+      modelName.replace(/Model$/, "").replace(/Frame$/, ""),
+      true,
+    )}/${inflection.camelize(propertyKey, true)}`;
+    const path = options.path ?? defaultPath;
+    const { outEvents: _outEvents, inEvents: _inEvents, ...apiOptions } = options;
+    const optionsWithDefaults = {
+      ...apiOptions,
+      httpMethod: "GET" as HTTPMethods,
+    };
+
+    const existingApi = registeredApis.find(
+      (api) => api.modelName === modelName && api.methodName === methodName,
+    );
+    if (existingApi) {
+      assertNoConflictingPath("websocket", modelName, methodName, existingApi.path, path);
+      existingApi.path = path;
+
+      assertNoConflictingOptions(
+        "websocket",
+        modelName,
+        methodName,
+        existingApi.options,
+        optionsWithDefaults,
+      );
+      existingApi.options = {
+        ...existingApi.options,
+        ...optionsWithDefaults,
+      };
+
+      existingApi.websocketOptions = options;
+    } else {
+      registeredApis.push({
+        modelName,
+        methodName,
+        path,
+        options: optionsWithDefaults,
+        websocketOptions: options,
+      });
+    }
+
+    const originalMethod = descriptor.value;
+    descriptor.value = async function (this: BaseModelClass | BaseFrameClass, ...args: unknown[]) {
+      if (this instanceof BaseModelClass) {
+        getLogger(convertDomainToCategory(this.modelName, "model")).debug(
+          "websocket: {model}.{method}",
+          {
+            model: modelName,
+            method: methodName,
+          },
+        );
+      }
+
+      if (this instanceof BaseFrameClass) {
+        getLogger(convertDomainToCategory(this.frameName, "frame")).debug(
+          "websocket: {model}.{method}",
+          {
+            model: modelName,
+            method: methodName,
+          },
+        );
+      }
+
+      return originalMethod.apply(this, args);
+    };
+  };
+}
+
 export function transactional(options: TransactionalOptions = {}) {
   const { isolation, readOnly, dbPreset = "w" } = options;
 
@@ -286,7 +386,7 @@ export function transactional(options: TransactionalOptions = {}) {
     const modelName = target.constructor.name.match(/(.+)Class$/)?.[1];
     assert(
       modelName,
-      `modelName is required on @stream decorator on ${target.constructor.name}.${propertyKey}`,
+      `modelName is required on @transactional decorator on ${target.constructor.name}.${propertyKey}`,
     );
     const methodName = propertyKey;