sonamu 0.9.13 → 0.9.15

package/dist/utils/utils.js

@@ -93,4 +93,4 @@ var init_utils = __esmMin((() => {}));
 //#endregion
 init_utils();
 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=
+//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXRpbHMuanMiLCJuYW1lcyI6W10sInNvdXJjZXMiOlsiLi4vLi4vc3JjL3V0aWxzL3V0aWxzLnRzIl0sInNvdXJjZXNDb250ZW50IjpbImltcG9ydCBmcyBmcm9tIFwiZnNcIjtcbmltcG9ydCBwYXRoIGZyb20gXCJwYXRoXCI7XG5cbmltcG9ydCB7IHR5cGUgRmFzdGlmeVJlcXVlc3QgfSBmcm9tIFwiZmFzdGlmeVwiO1xuXG5pbXBvcnQgeyB0eXBlIEFic29sdXRlUGF0aCB9IGZyb20gXCIuL3BhdGgtdXRpbHNcIjtcblxuZXhwb3J0IGZ1bmN0aW9uIGZpbmRBcHBSb290UGF0aCgpOiBBYnNvbHV0ZVBhdGgge1xuICBjb25zdCBhcGlSb290UGF0aCA9IGZpbmRBcGlSb290UGF0aCgpO1xuICByZXR1cm4gcGF0aC5kaXJuYW1lKGFwaVJvb3RQYXRoKSBhcyBBYnNvbHV0ZVBhdGg7XG59XG5cbmV4cG9ydCBmdW5jdGlvbiBmaW5kQXBpUm9vdFBhdGgoKTogQWJzb2x1dGVQYXRoIHtcbiAgLy8gTk9URTogZm9yIHN1cHBvcnQgbnBtIC8geWFybiAvIHBucG0gd29ya3NwYWNlc1xuICAvLyDtlZjsp4Drp4wgd29ya3NwYWNlIOyTsOuptCBwcm9jZXNzLmN3ZCgpIO2VmOuptCDrkJjripTrjbAuLi4g7J206rG0IOuCmOykkeyXkCDtmJHsnZgg7ZuEIOyImOygle2VmOuKlOqxuOuhnFxuICBjb25zdCB3b3Jrc3BhY2VQYXRoID0gcHJvY2Vzcy5lbnYuUE5QTV9TQ1JJUFRfU1JDX0RJUiA/PyBwcm9jZXNzLmVudi5JTklUX0NXRDtcbiAgaWYgKG5vbk51bGxhYmxlKHdvcmtzcGFjZVBhdGgpKSB7XG4gICAgcmV0dXJuIHdvcmtzcGFjZVBhdGggYXMgQWJzb2x1dGVQYXRoO1xuICB9XG5cbiAgaWYgKG5vbk51bGxhYmxlKHByb2Nlc3MuZW52LlBOUE1fUEFDS0FHRV9OQU1FKSkge1xuICAgIHJldHVybiBwcm9jZXNzLmN3ZCgpLnNwbGl0KHBhdGguc2VwKS5qb2luKHBhdGguc2VwKSBhcyBBYnNvbHV0ZVBhdGg7XG4gIH1cblxuICBjb25zdCBjd2RQYWNrYWdlUGF0aCA9IHBhdGguam9pbihwcm9jZXNzLmN3ZCgpLCBcInBhY2thZ2UuanNvblwiKTtcbiAgaWYgKGZzLmV4aXN0c1N5bmMoY3dkUGFja2FnZVBhdGgpKSB7XG4gICAgcmV0dXJuIHByb2Nlc3MuY3dkKCkuc3BsaXQocGF0aC5zZXApLmpvaW4ocGF0aC5zZXApIGFzIEFic29sdXRlUGF0aDtcbiAgfVxuXG4gIGNvbnN0IGJhc2VQYXRoID0gaW1wb3J0Lm1ldGEuZmlsZW5hbWU7XG4gIGxldCBkaXIgPSBwYXRoLmRpcm5hbWUoYmFzZVBhdGgpO1xuICBpZiAoZGlyLmluY2x1ZGVzKFwiLy55YXJuL1wiKSkge1xuICAgIGRpciA9IGRpci5zcGxpdChcIi8ueWFybi9cIilbMF07XG4gIH1cblxuICBkbyB7XG4gICAgaWYgKGZzLmV4aXN0c1N5bmMocGF0aC5qb2luKGRpciwgXCIvcGFja2FnZS5qc29uXCIpKSkge1xuICAgICAgcmV0dXJuIGRpci5zcGxpdChwYXRoLnNlcCkuam9pbihwYXRoLnNlcCkgYXMgQWJzb2x1dGVQYXRoO1xuICAgIH1cbiAgICBkaXIgPSBkaXIuc3BsaXQocGF0aC5zZXApLnNsaWNlKDAsIC0xKS5qb2luKHBhdGguc2VwKTtcbiAgfSB3aGlsZSAoZGlyLnNwbGl0KHBhdGguc2VwKS5sZW5ndGggPiAxKTtcbiAgdGhyb3cgbmV3IEVycm9yKFwiQ2Fubm90IGZpbmQgQXBwUm9vdCB1c2luZyBTb25hbXUgLTJcIik7XG59XG5cbmV4cG9ydCBmdW5jdGlvbiBub25OdWxsYWJsZTxUPih2YWx1ZTogVCk6IHZhbHVlIGlzIE5vbk51bGxhYmxlPFQ+IHtcbiAgcmV0dXJuIHZhbHVlICE9PSBudWxsICYmIHZhbHVlICE9PSB1bmRlZmluZWQ7XG59XG5cbmV4cG9ydCBmdW5jdGlvbiBleGhhdXN0aXZlKF9wYXJhbTogbmV2ZXIpOiBuZXZlciB7XG4gIHRocm93IG5ldyBFcnJvcihgZXhoYXVzdGl2ZWApO1xufVxuXG4vLyDsnbzrsJgg67KE7KCEXG5leHBvcnQgZnVuY3Rpb24gYXNzZXJ0RXhpc3RzPFQ+KHZhbHVlOiBUIHwgbnVsbCB8IHVuZGVmaW5lZCwgbWVzc2FnZT86IHN0cmluZyk6IFQge1xuICBpZiAodmFsdWUgPT09IG51bGwgfHwgdmFsdWUgPT09IHVuZGVmaW5lZCkge1xuICAgIHRocm93IG5ldyBFcnJvcihtZXNzYWdlID8/IFwiVmFsdWUgbXVzdCBleGlzdFwiKTtcbiAgfVxuICByZXR1cm4gdmFsdWU7XG59XG5cbi8vIG51bGzrp4wg7LK07YGsXG5leHBvcnQgZnVuY3Rpb24gYXNzZXJ0Tm90TnVsbDxUPih2YWx1ZTogVCB8IG51bGwsIG1lc3NhZ2U/OiBzdHJpbmcpOiBUIHtcbiAgaWYgKHZhbHVlID09PSBudWxsKSB7XG4gICAgdGhyb3cgbmV3IEVycm9yKG1lc3NhZ2UgPz8gXCJWYWx1ZSBtdXN0IG5vdCBiZSBudWxsXCIpO1xuICB9XG4gIHJldHVybiB2YWx1ZTtcbn1cbi8vIHVuZGVmaW5lZOunjCDssrTtgaxcbmV4cG9ydCBmdW5jdGlvbiBhc3NlcnREZWZpbmVkPFQ+KHZhbHVlOiBUIHwgdW5kZWZpbmVkLCBtZXNzYWdlPzogc3RyaW5nKTogVCB7XG4gIGlmICh2YWx1ZSA9PT0gdW5kZWZpbmVkKSB7XG4gICAgdGhyb3cgbmV3IEVycm9yKG1lc3NhZ2UgPz8gXCJWYWx1ZSBtdXN0IGJlIGRlZmluZWRcIik7XG4gIH1cbiAgcmV0dXJuIHZhbHVlO1xufVxuXG4vLyBsb2Rhc2ggaW50ZXJzZWN0aW9uQnkg64yA7LK0XG5leHBvcnQgZnVuY3Rpb24gaW50ZXJzZWN0aW9uQnk8VCwgSz4oXG4gIGFycjE6IHJlYWRvbmx5IFRbXSxcbiAgYXJyMjogcmVhZG9ubHkgVFtdLFxuICBpdGVyYXRlZTogKGl0ZW06IFQpID0+IEssXG4pOiBUW10ge1xuICBjb25zdCBhcnIyS2V5cyA9IG5ldyBTZXQoYXJyMi5tYXAoaXRlcmF0ZWUpKTtcbiAgcmV0dXJuIGFycjEuZmlsdGVyKChpdGVtKSA9PiBhcnIyS2V5cy5oYXMoaXRlcmF0ZWUoaXRlbSkpKTtcbn1cbi8vIGxvZGFzaCBkaWZmZXJlbmNlV2l0aCDrjIDssrRcbmV4cG9ydCBmdW5jdGlvbiBkaWZmZXJlbmNlV2l0aDxUPihcbiAgYXJyMTogcmVhZG9ubHkgVFtdLFxuICBhcnIyOiByZWFkb25seSBUW10sXG4gIGNvbXBhcmF0b3I6IChhOiBULCBiOiBUKSA9PiBib29sZWFuLFxuKTogVFtdIHtcbiAgcmV0dXJuIGFycjEuZmlsdGVyKChpdGVtQSkgPT4gIWFycjIuc29tZSgoaXRlbUIpID0+IGNvbXBhcmF0b3IoaXRlbUEsIGl0ZW1CKSkpO1xufVxuXG4vLyBiaW9tZS1pZ25vcmUgbGludC9zdXNwaWNpb3VzL25vRXhwbGljaXRBbnk6IGR5bmFtaWMgcHJvcGVydHkgYWNjZXNzXG5leHBvcnQgZnVuY3Rpb24gbWVyZ2U8VCBleHRlbmRzIFJlY29yZDxzdHJpbmcsIGFueT4+KGRlZmF1bHRPYmo6IFQsIHVzZXJPYmo6IFQpOiBUIHtcbiAgLy8g7JuQ67O4IOuztOyhtOydhCDsnITtlbQgZGVmYXVsdE9iaiDrs7XsgqxcbiAgY29uc3QgcmVzdWx0ID0geyAuLi5kZWZhdWx0T2JqIH07XG5cbiAgLy8gdXNlck9iauydmCDqsIEg7IaN7ISx7J2EIOyInO2ajFxuICBmb3IgKGNvbnN0IGtleSBpbiB1c2VyT2JqKSB7XG4gICAgLy8gdXNlck9iauydmCBvd24gcHJvcGVydHnrp4wg7LKY66asICjtlITroZzthqDtg4DsnoUg7LK07J24IOygnOyZuClcbiAgICBpZiAoT2JqZWN0Lmhhc093bih1c2VyT2JqLCBrZXkpKSB7XG4gICAgICBjb25zdCB1c2VyVmFsdWUgPSB1c2VyT2JqW2tleV07XG4gICAgICBjb25zdCBkZWZhdWx0VmFsdWUgPSByZXN1bHRba2V5XTtcblxuICAgICAgLy8g65GQIOqwkuydtCDrqqjrkZAg6rCd7LK07J206rOgLCDrsLDsl7TsnbQg7JWE64uMIOqyveyasCDsnqzqt4DsoIHsnLzroZwg67OR7ZWpXG4gICAgICBpZiAoaXNQbGFpbk9iamVjdCh1c2VyVmFsdWUpICYmIGlzUGxhaW5PYmplY3QoZGVmYXVsdFZhbHVlKSkge1xuICAgICAgICByZXN1bHRba2V5XSA9IG1lcmdlKGRlZmF1bHRWYWx1ZSwgdXNlclZhbHVlKTtcbiAgICAgIH0gZWxzZSB7XG4gICAgICAgIC8vIOq3uCDsmbjsnZgg6rK97JqwIHVzZXJPYmrsnZgg6rCS7Jy866GcIOuNruyWtOyTsOq4sFxuICAgICAgICByZXN1bHRba2V5XSA9IHVzZXJWYWx1ZTtcbiAgICAgIH1cbiAgICB9XG4gIH1cblxuICByZXR1cm4gcmVzdWx0O1xufVxuXG4vLyBwbGFpbiBvYmplY3Qg7YyQ67OEIO2XrO2NvCDtlajsiJhcbi8vICjrsLDsl7QsIG51bGwsIERhdGUg65Ox7J2EIOygnOyZuO2VnCDsiJzsiJgg6rCd7LK066eMIHRydWUpXG5leHBvcnQgZnVuY3Rpb24gaXNQbGFpbk9iamVjdCh2YWx1ZTogdW5rbm93bik6IHZhbHVlIGlzIFJlY29yZDxzdHJpbmcsIHVua25vd24+IHtcbiAgcmV0dXJuIChcbiAgICB2YWx1ZSAhPT0gbnVsbCAmJlxuICAgIHR5cGVvZiB2YWx1ZSA9PT0gXCJvYmplY3RcIiAmJlxuICAgICFBcnJheS5pc0FycmF5KHZhbHVlKSAmJlxuICAgIE9iamVjdC5wcm90b3R5cGUudG9TdHJpbmcuY2FsbCh2YWx1ZSkgPT09IFwiW29iamVjdCBPYmplY3RdXCJcbiAgKTtcbn1cblxuLy8gQ29udmVydCBGYXN0aWZ5IGhlYWRlcnMgdG8gc3RhbmRhcmQgSGVhZGVycyBvYmplY3RcbmV4cG9ydCBmdW5jdGlvbiBjb252ZXJ0RmFzdGlmeUhlYWRlcnNUb1N0YW5kYXJkKGhlYWRlcnM6IEZhc3RpZnlSZXF1ZXN0W1wiaGVhZGVyc1wiXSk6IEhlYWRlcnMge1xuICBjb25zdCBoZWFkZXJzT2JqID0gbmV3IEhlYWRlcnMoKTtcbiAgT2JqZWN0LmVudHJpZXMoaGVhZGVycykuZm9yRWFjaCgoW2tleSwgdmFsdWVdKSA9PiB7XG4gICAgaWYgKHZhbHVlKSBoZWFkZXJzT2JqLmFwcGVuZChrZXksIHZhbHVlLnRvU3RyaW5nKCkpO1xuICB9KTtcbiAgcmV0dXJuIGhlYWRlcnNPYmo7XG59XG4iXSwibWFwcGluZ3MiOiI7Ozs7O0FBT0EsU0FBZ0Isa0JBQWdDO0NBQzlDLE1BQU0sY0FBYyxpQkFBaUI7QUFDckMsUUFBTyxLQUFLLFFBQVEsWUFBWTs7QUFHbEMsU0FBZ0Isa0JBQWdDO0NBRzlDLE1BQU0sZ0JBQWdCLFFBQVEsSUFBSSx1QkFBdUIsUUFBUSxJQUFJO0FBQ3JFLEtBQUksWUFBWSxjQUFjLEVBQUU7QUFDOUIsU0FBTzs7QUFHVCxLQUFJLFlBQVksUUFBUSxJQUFJLGtCQUFrQixFQUFFO0FBQzlDLFNBQU8sUUFBUSxLQUFLLENBQUMsTUFBTSxLQUFLLElBQUksQ0FBQyxLQUFLLEtBQUssSUFBSTs7Q0FHckQsTUFBTSxpQkFBaUIsS0FBSyxLQUFLLFFBQVEsS0FBSyxFQUFFLGVBQWU7QUFDL0QsS0FBSSxHQUFHLFdBQVcsZUFBZSxFQUFFO0FBQ2pDLFNBQU8sUUFBUSxLQUFLLENBQUMsTUFBTSxLQUFLLElBQUksQ0FBQyxLQUFLLEtBQUssSUFBSTs7Q0FHckQsTUFBTSxXQUFXLE9BQU8sS0FBSztDQUM3QixJQUFJLE1BQU0sS0FBSyxRQUFRLFNBQVM7QUFDaEMsS0FBSSxJQUFJLFNBQVMsVUFBVSxFQUFFO0FBQzNCLFFBQU0sSUFBSSxNQUFNLFVBQVUsQ0FBQzs7QUFHN0IsSUFBRztBQUNELE1BQUksR0FBRyxXQUFXLEtBQUssS0FBSyxLQUFLLGdCQUFnQixDQUFDLEVBQUU7QUFDbEQsVUFBTyxJQUFJLE1BQU0sS0FBSyxJQUFJLENBQUMsS0FBSyxLQUFLLElBQUk7O0FBRTNDLFFBQU0sSUFBSSxNQUFNLEtBQUssSUFBSSxDQUFDLE1BQU0sR0FBRyxDQUFDLEVBQUUsQ0FBQyxLQUFLLEtBQUssSUFBSTtVQUM5QyxJQUFJLE1BQU0sS0FBSyxJQUFJLENBQUMsU0FBUztBQUN0QyxPQUFNLElBQUksTUFBTSxzQ0FBc0M7O0FBR3hELFNBQWdCLFlBQWUsT0FBbUM7QUFDaEUsUUFBTyxVQUFVLFFBQVEsVUFBVTs7QUFHckMsU0FBZ0IsV0FBVyxRQUFzQjtBQUMvQyxPQUFNLElBQUksTUFBTSxhQUFhOztBQUkvQixTQUFnQixhQUFnQixPQUE2QixTQUFxQjtBQUNoRixLQUFJLFVBQVUsUUFBUSxVQUFVLFdBQVc7QUFDekMsUUFBTSxJQUFJLE1BQU0sV0FBVyxtQkFBbUI7O0FBRWhELFFBQU87O0FBSVQsU0FBZ0IsY0FBaUIsT0FBaUIsU0FBcUI7QUFDckUsS0FBSSxVQUFVLE1BQU07QUFDbEIsUUFBTSxJQUFJLE1BQU0sV0FBVyx5QkFBeUI7O0FBRXRELFFBQU87O0FBR1QsU0FBZ0IsY0FBaUIsT0FBc0IsU0FBcUI7QUFDMUUsS0FBSSxVQUFVLFdBQVc7QUFDdkIsUUFBTSxJQUFJLE1BQU0sV0FBVyx3QkFBd0I7O0FBRXJELFFBQU87O0FBSVQsU0FBZ0IsZUFDZCxNQUNBLE1BQ0EsVUFDSztDQUNMLE1BQU0sV0FBVyxJQUFJLElBQUksS0FBSyxJQUFJLFNBQVMsQ0FBQztBQUM1QyxRQUFPLEtBQUssUUFBUSxTQUFTLFNBQVMsSUFBSSxTQUFTLEtBQUssQ0FBQyxDQUFDOztBQUc1RCxTQUFnQixlQUNkLE1BQ0EsTUFDQSxZQUNLO0FBQ0wsUUFBTyxLQUFLLFFBQVEsVUFBVSxDQUFDLEtBQUssTUFBTSxVQUFVLFdBQVcsT0FBTyxNQUFNLENBQUMsQ0FBQzs7QUFJaEYsU0FBZ0IsTUFBcUMsWUFBZSxTQUFlO0NBRWpGLE1BQU0sU0FBUyxFQUFFLEdBQUcsWUFBWTtBQUdoQyxNQUFLLE1BQU0sT0FBTyxTQUFTO0FBRXpCLE1BQUksT0FBTyxPQUFPLFNBQVMsSUFBSSxFQUFFO0dBQy9CLE1BQU0sWUFBWSxRQUFRO0dBQzFCLE1BQU0sZUFBZSxPQUFPO0FBRzVCLE9BQUksY0FBYyxVQUFVLElBQUksY0FBYyxhQUFhLEVBQUU7QUFDM0QsV0FBTyxPQUFPLE1BQU0sY0FBYyxVQUFVO1VBQ3ZDO0FBRUwsV0FBTyxPQUFPOzs7O0FBS3BCLFFBQU87O0FBS1QsU0FBZ0IsY0FBYyxPQUFrRDtBQUM5RSxRQUNFLFVBQVUsUUFDVixPQUFPLFVBQVUsWUFDakIsQ0FBQyxNQUFNLFFBQVEsTUFBTSxJQUNyQixPQUFPLFVBQVUsU0FBUyxLQUFLLE1BQU0sS0FBSzs7QUFLOUMsU0FBZ0IsZ0NBQWdDLFNBQTZDO0NBQzNGLE1BQU0sYUFBYSxJQUFJLFNBQVM7QUFDaEMsUUFBTyxRQUFRLFFBQVEsQ0FBQyxTQUFTLENBQUMsS0FBSyxXQUFXO0FBQ2hELE1BQUksTUFBTyxZQUFXLE9BQU8sS0FBSyxNQUFNLFVBQVUsQ0FBQztHQUNuRDtBQUNGLFFBQU8ifQ==

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sonamu",
-  "version": "0.9.13",
+  "version": "0.9.15",
   "description": "Sonamu — TypeScript Fullstack API Framework",
   "keywords": [
     "framework",
@@ -129,8 +129,8 @@
     "tsicli": "^1.0.5",
     "vite": "8.0.5",
     "vitest": "^4.1.2",
-    "@sonamu-kit/ts-loader": "^2.2.0",
     "@sonamu-kit/hmr-runner": "^0.2.0",
+    "@sonamu-kit/ts-loader": "^2.2.0",
     "@sonamu-kit/hmr-hook": "^0.5.1",
     "@sonamu-kit/tasks": "^0.3.0"
   },

package/src/database/puri.ts

@@ -40,6 +40,25 @@ import {
 } from "./puri.types";
 import { FUZZY_OPERATORS } from "./puri.types";
 
+type PuriOrderByDirection = "asc" | "desc";
+type PuriOrderByNulls = "first" | "last";
+type PuriOrderByExpression = SqlExpression<"number"> | SqlExpression<"string">;
+type PuriOrderByItem<TColumn extends string> = {
+  column: TColumn | PuriOrderByExpression;
+  order?: PuriOrderByDirection;
+  nulls?: PuriOrderByNulls;
+};
+type PuriOrderByEntry<TColumn extends string> =
+  | TColumn
+  | PuriOrderByExpression
+  | PuriOrderByItem<TColumn>;
+type PuriOrderByRuntimeItem = {
+  column: string | PuriOrderByExpression;
+  order?: PuriOrderByDirection;
+  nulls?: PuriOrderByNulls;
+};
+type PuriOrderByRuntimeEntry = string | PuriOrderByExpression | PuriOrderByRuntimeItem;
+
 function normalizeFuzzyOperator(operator?: string): FuzzyOperator {
   const normalized = operator?.trim() ?? "<%";
   const fuzzyOperator = FUZZY_OPERATORS.find((candidate) => candidate === normalized);
@@ -51,6 +70,42 @@ function normalizeFuzzyOperator(operator?: string): FuzzyOperator {
   return fuzzyOperator;
 }
 
+function normalizeOrderByDirection(direction: PuriOrderByDirection = "asc"): PuriOrderByDirection {
+  if (direction !== "asc" && direction !== "desc") {
+    throw new Error(`Invalid order direction: ${direction}`);
+  }
+
+  return direction;
+}
+
+function normalizeOrderByNulls(nulls?: PuriOrderByNulls): PuriOrderByNulls | undefined {
+  if (nulls === undefined) {
+    return undefined;
+  }
+
+  if (nulls !== "first" && nulls !== "last") {
+    throw new Error(`Invalid order nulls: ${nulls}`);
+  }
+
+  return nulls;
+}
+
+function formatNullsSuffix(nulls?: PuriOrderByNulls): string {
+  if (!nulls) {
+    return "";
+  }
+
+  return ` NULLS ${nulls.toUpperCase()}`;
+}
+
+function isOrderByEntries(value: unknown): value is readonly PuriOrderByRuntimeEntry[] {
+  return Array.isArray(value);
+}
+
+function isSqlExpression(value: PuriOrderByRuntimeEntry): value is PuriOrderByExpression {
+  return typeof value === "object" && "_type" in value && value._type === "sql_expression";
+}
+
 export class Puri<TSchema, TTables extends Record<string, any>, TResult> {
   private knexQuery: Knex.QueryBuilder;
   private tableSpec: TableSpec | null = null;
@@ -837,19 +892,49 @@ export class Puri<TSchema, TTables extends Record<string, any>, TResult> {
 
   // ORDER BY (SqlExpression으로도 할 수 있어야 함)
   orderBy<TColumn extends ResultAvailableColumns<TTables, TResult>>(
-    column: TColumn | SqlExpression<"number"> | SqlExpression<"string">,
-    direction: "asc" | "desc",
+    column: TColumn | PuriOrderByExpression,
+    direction?: PuriOrderByDirection,
+    nulls?: PuriOrderByNulls,
+  ): this;
+  orderBy<TColumn extends ResultAvailableColumns<TTables, TResult>>(
+    columns: readonly PuriOrderByEntry<TColumn>[],
   ): this;
   orderBy(
-    column: string | SqlExpression<"number"> | SqlExpression<"string">,
-    direction: "asc" | "desc" = "asc",
+    columnOrColumns: string | PuriOrderByExpression | readonly PuriOrderByRuntimeEntry[],
+    direction: PuriOrderByDirection = "asc",
+    nulls?: PuriOrderByNulls,
   ): this {
+    if (isOrderByEntries(columnOrColumns)) {
+      for (const entry of columnOrColumns) {
+        if (typeof entry === "string" || isSqlExpression(entry)) {
+          this.applyOrderBy(entry);
+        } else {
+          this.applyOrderBy(entry.column, entry.order, entry.nulls);
+        }
+      }
+      return this;
+    }
+
+    this.applyOrderBy(columnOrColumns, direction, nulls);
+    return this;
+  }
+
+  private applyOrderBy(
+    column: string | PuriOrderByExpression,
+    direction?: PuriOrderByDirection,
+    nulls?: PuriOrderByNulls,
+  ): void {
+    const normalizedDirection = normalizeOrderByDirection(direction);
+    const normalizedNulls = normalizeOrderByNulls(nulls);
+
     if (typeof column === "object") {
-      this.knexQuery.orderByRaw(`${column._sql} ${direction}`, column._params);
+      this.knexQuery.orderByRaw(
+        `${column._sql} ${normalizedDirection}${formatNullsSuffix(normalizedNulls)}`,
+        column._params,
+      );
     } else {
-      this.knexQuery.orderBy(column, direction);
+      this.knexQuery.orderBy(column, normalizedDirection, normalizedNulls);
     }
-    return this;
   }
 
   forUpdate(): this {

package/src/database/puri.types.test-d.ts

@@ -477,3 +477,73 @@ describe("Puri locking methods", () => {
     expectTypeOf(result).resolves.toEqualTypeOf<MockSchema["users"]>();
   });
 });
+
+describe("Puri orderBy methods", () => {
+  it("단일 컬럼 null ordering과 체이닝 타입을 지원한다", () => {
+    type Query = Puri<MockSchema, { users: MockSchema["users"] }, MockSchema["users"]>;
+    const query = {} as Query;
+
+    expectTypeOf(query.orderBy("id")).toEqualTypeOf<Query>();
+    expectTypeOf(query.orderBy("id", "asc")).toEqualTypeOf<Query>();
+    expectTypeOf(query.orderBy("id", "desc", "last")).toEqualTypeOf<Query>();
+    expectTypeOf(query.orderBy("users.department_id", "asc", "first")).toEqualTypeOf<Query>();
+  });
+
+  it("여러 컬럼 orderBy item 배열을 지원한다", () => {
+    type Query = Puri<MockSchema, { users: MockSchema["users"] }, MockSchema["users"]>;
+    const query = {} as Query;
+
+    expectTypeOf(query.orderBy(["name", "email"])).toEqualTypeOf<Query>();
+    expectTypeOf(
+      query.orderBy([
+        { column: "name" },
+        { column: "email", order: "asc" },
+        { column: "users.department_id", order: "desc", nulls: "last" },
+      ]),
+    ).toEqualTypeOf<Query>();
+  });
+
+  it("select 결과 컬럼을 orderBy에 사용할 수 있다", () => {
+    type Result = { post_count: number };
+    type Query = Puri<MockSchema, { users: MockSchema["users"] }, Result>;
+    const query = {} as Query;
+
+    expectTypeOf(query.orderBy("post_count", "desc", "last")).toEqualTypeOf<Query>();
+    expectTypeOf(query.orderBy(["post_count"])).toEqualTypeOf<Query>();
+    expectTypeOf(
+      query.orderBy([{ column: "post_count", order: "desc", nulls: "last" }]),
+    ).toEqualTypeOf<Query>();
+  });
+
+  it("SqlExpression orderBy를 지원한다", () => {
+    type Query = Puri<MockSchema, { users: MockSchema["users"] }, MockSchema["users"]>;
+    const query = {} as Query;
+    const expression = Puri.rawNumber("COUNT(*)");
+
+    expectTypeOf(query.orderBy(expression, "desc", "last")).toEqualTypeOf<Query>();
+    expectTypeOf(query.orderBy([expression])).toEqualTypeOf<Query>();
+    expectTypeOf(
+      query.orderBy([{ column: expression, order: "desc", nulls: "first" }]),
+    ).toEqualTypeOf<Query>();
+  });
+
+  it("잘못된 direction, nulls, column은 거부한다", () => {
+    type Query = Puri<MockSchema, { users: MockSchema["users"] }, MockSchema["users"]>;
+    const query = {} as Query;
+
+    // @ts-expect-error direction은 asc/desc만 허용한다.
+    query.orderBy("id", "ascending");
+
+    // @ts-expect-error nulls는 first/last만 허용한다.
+    query.orderBy("id", "asc", "middle");
+
+    // @ts-expect-error typed Puri에서는 존재하지 않는 컬럼을 허용하지 않는다.
+    query.orderBy("missing_column", "asc");
+
+    // @ts-expect-error 배열 item의 column도 typed Puri 컬럼 제약을 따른다.
+    query.orderBy([{ column: "missing_column", order: "asc" }]);
+
+    // @ts-expect-error string 배열도 typed Puri 컬럼 제약을 따른다.
+    query.orderBy(["name", "missing_column"]);
+  });
+});

package/src/migration/__tests__/code-generation.search-text.test.ts

@@ -3,10 +3,11 @@ import { describe, expect, test } from "vitest";
 import { Sonamu } from "../../api";
 import { Entity } from "../../entity/entity";
 import { EntityManager } from "../../entity/entity-manager";
-import { type MigrationSet } from "../../types/types";
+import { type MigrationIndex, type MigrationSet } from "../../types/types";
 import {
   generateAlterCode,
   generateCreateCode,
+  getAlterIndexesTo,
   setMigrationIndexDefaults,
 } from "../code-generation";
 import { getMigrationSetFromEntity } from "../migration-set";
@@ -387,3 +388,147 @@ describe("code-generation searchText/opclass DDL", () => {
     expect(migration.formatted).toContain("USING gin(search_text gin_trgm_ops);");
   });
 });
+
+describe("code-generation partial index DDL", () => {
+  test("unique partial index WHERE predicate를 출력해야 한다", async () => {
+    const migrationSet: MigrationSet = {
+      table: "partial_index_users",
+      columns: [
+        { name: "id", type: "integer", nullable: false },
+        { name: "email", type: "string", nullable: false },
+        { name: "deleted_at", type: "date", nullable: true },
+      ],
+      indexes: [
+        {
+          type: "unique",
+          name: "partial_index_users_email_active_unique",
+          columns: [{ name: "email" }],
+          nullsNotDistinct: true,
+          where: "deleted_at IS NULL",
+        },
+      ],
+      foreigns: [],
+    };
+
+    const [migration] = await generateCreateCode(migrationSet);
+
+    expect(migration.formatted).toContain(
+      "CREATE UNIQUE INDEX partial_index_users_email_active_unique ON",
+    );
+    expect(migration.formatted).toContain("NULLS NOT DISTINCT WHERE deleted_at IS NULL;");
+  });
+
+  test("vector partial index WHERE predicate를 출력해야 한다", async () => {
+    const migrationSet: MigrationSet = {
+      table: "partial_index_vectors",
+      columns: [
+        { name: "id", type: "integer", nullable: false },
+        { name: "embedding", type: "vector", dimensions: 1536, nullable: true },
+      ],
+      indexes: [
+        {
+          type: "hnsw",
+          name: "partial_index_vectors_embedding_hnsw",
+          columns: [{ name: "embedding", vectorOps: "vector_cosine_ops" }],
+          where: "embedding IS NOT NULL",
+        },
+      ],
+      foreigns: [],
+    };
+
+    const [migration] = await generateCreateCode(migrationSet);
+
+    expect(migration.formatted).toContain(
+      "USING hnsw (embedding vector_cosine_ops) WITH (m = 16, ef_construction = 64) WHERE embedding IS NOT NULL",
+    );
+  });
+
+  test("pgroonga partial index WHERE predicate를 출력해야 한다", async () => {
+    const entity = await registerEntity({
+      id: "CodeGenerationPgroongaPartial",
+      table: "code_generation_pgroonga_partial",
+      props: [
+        { name: "id", type: "integer" },
+        { name: "title", type: "string" },
+        { name: "deleted_at", type: "date", nullable: true },
+      ],
+      indexes: [
+        {
+          type: "index",
+          name: "code_generation_pgroonga_partial_title_index",
+          using: "pgroonga",
+          columns: [{ name: "title" }],
+          where: "deleted_at IS NULL",
+        },
+      ],
+    });
+
+    const [migration] = await generateCreateCode(getMigrationSetFromEntity(entity));
+
+    expect(migration.formatted).toContain(
+      "USING pgroonga (title) WITH (tokenizer='TokenMecab') WHERE deleted_at IS NULL;",
+    );
+  });
+
+  test("partial index predicate의 바깥 괄호 차이는 alter diff에서 no-op이어야 한다", () => {
+    const entityIndex: MigrationIndex = {
+      type: "index",
+      name: "partial_index_users_email_active_index",
+      columns: [{ name: "email" }],
+      where: "deleted_at IS NULL",
+    };
+    const dbIndex: MigrationIndex = {
+      ...setMigrationIndexDefaults(entityIndex),
+      where: "(deleted_at IS NULL)",
+    };
+
+    const alterIndexesTo = getAlterIndexesTo([entityIndex], [dbIndex]);
+
+    expect(alterIndexesTo.add).toHaveLength(0);
+    expect(alterIndexesTo.drop).toHaveLength(0);
+  });
+
+  test("partial index predicate 변경은 alter diff에서 drop/add 대상이어야 한다", async () => {
+    const previousIndex: MigrationIndex = {
+      type: "index",
+      name: "partial_index_users_email_active_index",
+      columns: [{ name: "email" }],
+      where: "deleted_at IS NULL",
+    };
+    const nextIndex: MigrationIndex = {
+      ...previousIndex,
+      where: "archived_at IS NULL",
+    };
+
+    const alterIndexesTo = getAlterIndexesTo(
+      [nextIndex],
+      [setMigrationIndexDefaults(previousIndex)],
+    );
+
+    expect(alterIndexesTo.add).toHaveLength(1);
+    expect(alterIndexesTo.drop).toHaveLength(1);
+
+    const entitySet: MigrationSet = {
+      table: "partial_index_users",
+      columns: [
+        { name: "id", type: "integer", nullable: false },
+        { name: "email", type: "string", nullable: false },
+        { name: "deleted_at", type: "date", nullable: true },
+        { name: "archived_at", type: "date", nullable: true },
+      ],
+      indexes: [nextIndex],
+      foreigns: [],
+    };
+    const dbSet: MigrationSet = {
+      ...entitySet,
+      indexes: [setMigrationIndexDefaults(previousIndex)],
+    };
+
+    const [migration] = await generateAlterCode(entitySet, dbSet);
+
+    expect(migration.formatted).toContain(
+      'table.dropIndex(["email"], "partial_index_users_email_active_index")',
+    );
+    expect(migration.formatted).toContain("WHERE archived_at IS NULL;");
+  });
+});

package/src/migration/code-generation.ts

@@ -963,6 +963,7 @@ function genIndexDefinition(index: MigrationIndex, table: string): string {
       : "";
 
   const usingClause = index.using === undefined ? "" : `USING ${index.using}`;
+  const whereClause = getIndexWhereClause(index);
 
   return `await knex.raw(
   \`CREATE ${methodMap[index.type]} ${index.name} ON ${table} ${usingClause}(${index.columns
@@ -982,12 +983,13 @@ function genIndexDefinition(index: MigrationIndex, table: string): string {
         col.nullsFirst === undefined ? "" : ` NULLS ${col.nullsFirst ? "FIRST" : "LAST"}`;
       return `${col.name}${opclassClause}${sortOrderClause}${nullsFirstClause}`;
     })
-    .join(", ")})${nullsNotDistinctClause};\`
+    .join(", ")})${nullsNotDistinctClause}${whereClause};\`
   );`;
 }
 
 function genPgroongaIndexDefinition(index: MigrationIndex, table: string) {
   const entity = EntityManager.getByTable(table);
+  const whereClause = getIndexWhereClause(index);
 
   // 복합 인덱스인 경우 ARRAY 사용
   const columnClause = (() => {
@@ -1001,7 +1003,7 @@ function genPgroongaIndexDefinition(index: MigrationIndex, table: string) {
   })();
 
   return `await knex.raw(
-  \`CREATE INDEX ${index.name} ON ${table} USING pgroonga (${columnClause}) WITH (tokenizer='TokenMecab');\`
+  \`CREATE INDEX ${index.name} ON ${table} USING pgroonga (${columnClause}) WITH (tokenizer='TokenMecab')${whereClause};\`
   )`;
 }
 
@@ -1035,23 +1037,29 @@ function getPgroongaColumnOption(column: EntityProp) {
 function genVectorIndexDefinition(index: MigrationIndex, table: string): string {
   const column = index.columns[0];
   const vectorOps = getIndexColumnOpclass(column) ?? "vector_cosine_ops";
+  const whereClause = getIndexWhereClause(index);
 
   // HNSW (Hierarchical Navigable Small World) - 권장: 빠른 검색, 높은 정확도
   if (index.type === "hnsw") {
     const m = index.m ?? 16;
     const efConstruction = index.efConstruction ?? 64;
-    return `await knex.raw(\`CREATE INDEX ${index.name} ON ${table} USING hnsw (${column.name} ${vectorOps}) WITH (m = ${m}, ef_construction = ${efConstruction})\`);`;
+    return `await knex.raw(\`CREATE INDEX ${index.name} ON ${table} USING hnsw (${column.name} ${vectorOps}) WITH (m = ${m}, ef_construction = ${efConstruction})${whereClause}\`);`;
   }
 
   // IVFFlat (Inverted File with Flat Compression) - 대용량, 비용 중요 시
   if (index.type === "ivfflat") {
     const lists = index.lists ?? 100;
-    return `await knex.raw(\`CREATE INDEX ${index.name} ON ${table} USING ivfflat (${column.name} ${vectorOps}) WITH (lists = ${lists})\`);`;
+    return `await knex.raw(\`CREATE INDEX ${index.name} ON ${table} USING ivfflat (${column.name} ${vectorOps}) WITH (lists = ${lists})${whereClause}\`);`;
   }
 
   throw new Error(`Unknown raw SQL index type: ${index.type}`);
 }
 
+function getIndexWhereClause(index: MigrationIndex): string {
+  const where = normalizeIndexWherePredicate(index.where);
+  return where ? ` WHERE ${where}` : "";
+}
+
 /**
  * 테이블 생성하는 케이스 - FK 생성
  */
@@ -1602,9 +1610,11 @@ export function getAlterIndexesTo(entityIndexes: MigrationIndex[], dbIndexes: Mi
       .join("//");
   };
 
+  const normalizedEntityIndexes = entityIndexes.map(setMigrationIndexDefaults);
+  const normalizedDbIndexes = dbIndexes.map(setMigrationIndexDefaults);
   const extraIndexes = {
-    db: diff(dbIndexes, entityIndexes.map(setMigrationIndexDefaults), identity),
-    entity: diff(entityIndexes.map(setMigrationIndexDefaults), dbIndexes, identity),
+    db: diff(normalizedDbIndexes, normalizedEntityIndexes, identity),
+    entity: diff(normalizedEntityIndexes, normalizedDbIndexes, identity),
   };
   if (extraIndexes.entity.length > 0) {
     indexesTo.add = indexesTo.add.concat(extraIndexes.entity);
@@ -1632,6 +1642,7 @@ export function setMigrationIndexDefaults(index: MigrationIndex): MigrationIndex
   const isVectorIndex = index.type === "hnsw" || index.type === "ivfflat";
   const supportsOrdering = !isVectorIndex && (!index.using || index.using === "btree");
   const normalizedUsing = isVectorIndex ? index.using : (index.using ?? "btree");
+  const normalizedWhere = normalizeIndexWherePredicate(index.where);
 
   return {
     ...index,
@@ -1647,9 +1658,77 @@ export function setMigrationIndexDefaults(index: MigrationIndex): MigrationIndex
     })),
     nullsNotDistinct: index.nullsNotDistinct ?? false,
     ...(normalizedUsing ? { using: normalizedUsing } : {}),
+    ...(normalizedWhere ? { where: normalizedWhere } : {}),
   };
 }
 
+function normalizeIndexWherePredicate(where: string | undefined): string | undefined {
+  if (!where) {
+    return undefined;
+  }
+
+  const trimmed = where.trim();
+  if (trimmed.length === 0) {
+    return undefined;
+  }
+
+  if (trimmed.startsWith("(") && trimmed.endsWith(")")) {
+    const closeIndex = findMatchingParenthesisInSql(trimmed, 0);
+    if (closeIndex === trimmed.length - 1) {
+      return trimmed.slice(1, -1).trim();
+    }
+  }
+
+  return trimmed;
+}
+
+function findMatchingParenthesisInSql(source: string, openIndex: number): number {
+  let depth = 0;
+  let inSingleQuote = false;
+  let inDoubleQuote = false;
+
+  for (let index = openIndex; index < source.length; index += 1) {
+    const char = source[index];
+    const nextChar = source[index + 1];
+
+    if (char === "'" && !inDoubleQuote) {
+      if (inSingleQuote && nextChar === "'") {
+        index += 1;
+        continue;
+      }
+      inSingleQuote = !inSingleQuote;
+      continue;
+    }
+
+    if (char === '"' && !inSingleQuote) {
+      if (inDoubleQuote && nextChar === '"') {
+        index += 1;
+        continue;
+      }
+      inDoubleQuote = !inDoubleQuote;
+      continue;
+    }
+
+    if (inSingleQuote || inDoubleQuote) {
+      continue;
+    }
+
+    if (char === "(") {
+      depth += 1;
+      continue;
+    }
+
+    if (char === ")") {
+      depth -= 1;
+      if (depth === 0) {
+        return index;
+      }
+    }
+  }
+
+  return -1;
+}
+
 /**
  * 테이블 변경 케이스 - Foreign Key 변경
  */

package/src/migration/postgresql-schema-reader.ts

@@ -56,6 +56,7 @@ type PgIndex = {
   nulls_not_distinct: boolean;
   column_order: number;
   index_definition: string;
+  predicate?: string | null;
 };
 
 type PgForeign = {
@@ -203,6 +204,7 @@ class PostgreSQLSchemaReaderClass {
         })),
 
         nullsNotDistinct: firstIndex.nulls_not_distinct,
+        ...(firstIndex.predicate ? { where: firstIndex.predicate } : {}),
         ...(using ? { using } : {}),
         ...this.parseVectorIndexOptions(restoredIndexType, parsedIndexDefinition.withOptions),
       };
@@ -310,7 +312,8 @@ class PostgreSQLSchemaReaderClass {
           END AS sort_order,
           ix.indnullsnotdistinct AS nulls_not_distinct,
           u.ord AS column_order,
-          pg_get_indexdef(ix.indexrelid) AS index_definition
+          pg_get_indexdef(ix.indexrelid) AS index_definition,
+          pg_get_expr(ix.indpred, ix.indrelid) AS predicate
       FROM pg_class t
       JOIN pg_index ix ON t.oid = ix.indrelid
       JOIN pg_class i ON i.oid = ix.indexrelid

package/src/skills/sonamu/i18n.md

@@ -147,15 +147,23 @@ SD("enum.UserRole.admin"); // → "관리자"
 
 ## localizedColumn
 
-Returns the value for the current locale when locale-specific columns exist in the DB:
+Returns the value for the current locale when locale-specific columns or locale maps exist in the DB:
 
 ```typescript
 import { localizedColumn } from "@/i18n/sd.generated";
 
 // DB: { name: "태그", name_ko: "태그", name_en: "Tag" }
 localizedColumn(tag, "name"); // → "태그" (ko) / "Tag" (en)
+
+// DB: { name: { ko: ["태그"], en: ["Tag"] } }
+localizedColumn(tag, "name"); // → ["태그"] (ko) / ["Tag"] (en)
 ```
 
+- `string[]` values are returned as arrays instead of being stringified.
+- Unsupported Context locales use `defaultLocale` before lookup.
+- Direct suffix/base scalar values such as numbers are stringified for compatibility.
+- Locale map values support only `string` and `string[]`.
+
 ## Sonamu UI Management
 
 `http://localhost:34900/sonamu-ui` → i18n tab: