@withwiz/toolkit 0.12.0 → 0.13.0

package/dist/core/geolocation/index.js

@@ -1,18 +1,18 @@
 import {
   GeoIPProviderFactory
-} from "../../chunk-VDRLJU6C.js";
-import {
-  IPApiProvider
-} from "../../chunk-E27YZK7O.js";
-import {
-  IPApiCoProvider
-} from "../../chunk-MRNRC45L.js";
+} from "../../chunk-Q5RPNLET.js";
 import {
   IPGeolocationProvider
 } from "../../chunk-GJYHMHTU.js";
 import {
   MaxMindProvider
 } from "../../chunk-R463CTX4.js";
+import {
+  IPApiProvider
+} from "../../chunk-E27YZK7O.js";
+import {
+  IPApiCoProvider
+} from "../../chunk-MRNRC45L.js";
 import {
   BaseGeoIPProvider,
   truncateString

package/dist/core/geolocation/providers/index.js

@@ -1,18 +1,18 @@
 import {
   GeoIPProviderFactory
-} from "../../../chunk-VDRLJU6C.js";
-import {
-  IPApiProvider
-} from "../../../chunk-E27YZK7O.js";
-import {
-  IPApiCoProvider
-} from "../../../chunk-MRNRC45L.js";
+} from "../../../chunk-Q5RPNLET.js";
 import {
   IPGeolocationProvider
 } from "../../../chunk-GJYHMHTU.js";
 import {
   MaxMindProvider
 } from "../../../chunk-R463CTX4.js";
+import {
+  IPApiProvider
+} from "../../../chunk-E27YZK7O.js";
+import {
+  IPApiCoProvider
+} from "../../../chunk-MRNRC45L.js";
 import {
   BaseGeoIPProvider,
   truncateString

package/dist/core/system/environment.js

@@ -1,6 +1,6 @@
 import {
   checkEnvironmentVariables
-} from "../../chunk-B2JZPUQ3.js";
+} from "../../chunk-L4WQRYMR.js";
 import "../../chunk-KWUOLKDO.js";
 import "../../chunk-QAIN3WNN.js";
 import "../../chunk-CRJUFA73.js";
@@ -8,8 +8,8 @@ import "../../chunk-IKZB26SK.js";
 import "../../chunk-TQMQ5XXG.js";
 import "../../chunk-7YWUKMZD.js";
 import "../../chunk-OVOBSYR4.js";
-import "../../chunk-PX535BHW.js";
 import "../../chunk-RHYETIUR.js";
+import "../../chunk-PX535BHW.js";
 import "../../chunk-ERFD6YAW.js";
 import "../../chunk-6J2EJVND.js";
 import "../../chunk-F3R3UYBF.js";

package/dist/core/system/health-check.js

@@ -1,6 +1,6 @@
 import {
   checkServiceHealth
-} from "../../chunk-ETXMWDXV.js";
+} from "../../chunk-TGEKWTFZ.js";
 import "../../chunk-PBVP7CFZ.js";
 import "../../chunk-KWUOLKDO.js";
 import "../../chunk-QAIN3WNN.js";

package/dist/core/system/index.js

@@ -1,15 +1,6 @@
-import {
-  getCpuInfo
-} from "../../chunk-DRTJSTEV.js";
-import {
-  getDiskInfo
-} from "../../chunk-E5TDIRBJ.js";
-import {
-  checkEnvironmentVariables
-} from "../../chunk-B2JZPUQ3.js";
 import {
   checkServiceHealth
-} from "../../chunk-ETXMWDXV.js";
+} from "../../chunk-TGEKWTFZ.js";
 import "../../chunk-PBVP7CFZ.js";
 import {
   getMemoryInfo
@@ -17,6 +8,15 @@ import {
 import {
   getNetworkInfo
 } from "../../chunk-WBHX4MJV.js";
+import {
+  getCpuInfo
+} from "../../chunk-DRTJSTEV.js";
+import {
+  getDiskInfo
+} from "../../chunk-E5TDIRBJ.js";
+import {
+  checkEnvironmentVariables
+} from "../../chunk-L4WQRYMR.js";
 import {
   getPlatform,
   getRecommendedCommands
@@ -29,8 +29,8 @@ import "../../chunk-IKZB26SK.js";
 import "../../chunk-TQMQ5XXG.js";
 import "../../chunk-7YWUKMZD.js";
 import "../../chunk-OVOBSYR4.js";
-import "../../chunk-PX535BHW.js";
 import "../../chunk-RHYETIUR.js";
+import "../../chunk-PX535BHW.js";
 import "../../chunk-ERFD6YAW.js";
 import "../../chunk-6J2EJVND.js";
 import "../../chunk-F3R3UYBF.js";

package/dist/core/utils/startup-banner.d.ts

@@ -0,0 +1,56 @@
+/**
+ * startup-banner — 공용 서버 구동 배너
+ *
+ * 모든 withwiz 서버 프로젝트에서 서버 구동 시 환경설정을 동일한 형식으로 출력한다.
+ * 외부 의존성 없음(순수 console) — Core tier.
+ *
+ * 사용 예:
+ *   import { printStartupBanner, mask, status } from '@withwiz/toolkit/core/utils/startup-banner';
+ *   printStartupBanner({
+ *     title: '🚀 My Service',
+ *     version: process.env.npm_package_version,
+ *     sections: [
+ *       { emoji: '⚙️', title: 'Environment', lines: [
+ *         ['Mode', process.env.NODE_ENV ?? 'development'],
+ *         ['Base URL', mask(process.env.BASE_URL, 'url')],
+ *       ]},
+ *     ],
+ *   });
+ */
+declare const colors: {
+    readonly reset: "\u001B[0m";
+    readonly bright: "\u001B[1m";
+    readonly dim: "\u001B[2m";
+    readonly cyan: "\u001B[36m";
+    readonly green: "\u001B[32m";
+    readonly yellow: "\u001B[33m";
+    readonly red: "\u001B[31m";
+};
+type Color = keyof typeof colors;
+export declare const c: (color: Color, text: string) => string;
+/** 민감/긴 값을 마스킹해 표시. url=host만, secret=앞 4글자, default=앞 20글자. */
+export declare function mask(value: string | undefined, type?: 'url' | 'secret' | 'default'): string;
+/** 불리언 상태를 ✓/✗ 로 표시. */
+export declare function status(condition: boolean): string;
+/** 기능 플래그 표시: 켜짐 ✓, 꺼짐 ⚠ OFF. */
+export declare function feature(condition: boolean): string;
+/** NODE_ENV 를 색상 라벨로. production=노랑, test=시안, 그 외=초록(DEVELOPMENT). */
+export declare function modeLabel(nodeEnv: string | undefined): string;
+export type BannerLine = [label: string, value: string];
+export interface BannerSection {
+    emoji: string;
+    title: string;
+    lines: BannerLine[];
+}
+export interface StartupBannerOptions {
+    title: string;
+    version?: string;
+    sections: BannerSection[];
+    width?: number;
+    labelWidth?: number;
+    locale?: string;
+    timeZone?: string;
+}
+/** 서버 구동 배너 출력 (런타임에 실제 로드된 값 사용). */
+export declare function printStartupBanner(opts: StartupBannerOptions): void;
+export {};

package/dist/core/utils/startup-banner.js

@@ -0,0 +1,78 @@
+import "../../chunk-N3ETBM74.js";
+
+// src/core/utils/startup-banner.ts
+var colors = {
+  reset: "\x1B[0m",
+  bright: "\x1B[1m",
+  dim: "\x1B[2m",
+  cyan: "\x1B[36m",
+  green: "\x1B[32m",
+  yellow: "\x1B[33m",
+  red: "\x1B[31m"
+};
+var c = (color, text) => `${colors[color]}${text}${colors.reset}`;
+function mask(value, type = "default") {
+  if (!value) return c("red", "\u2717 NOT_SET");
+  switch (type) {
+    case "url":
+      try {
+        const url = new URL(value);
+        return c("green", `\u2713 ${url.host}`);
+      } catch (e) {
+        return value.length > 15 ? value.substring(0, 15) + "..." : value;
+      }
+    case "secret":
+      return c("green", `\u2713 ${value.substring(0, 4)}***`);
+    default:
+      return c("green", `\u2713 ${value.length > 20 ? value.substring(0, 20) + "..." : value}`);
+  }
+}
+function status(condition) {
+  return condition ? c("green", "\u2713") : c("red", "\u2717");
+}
+function feature(condition) {
+  return condition ? status(true) : c("yellow", "\u26A0 OFF");
+}
+function modeLabel(nodeEnv) {
+  const mode = nodeEnv || "development";
+  if (mode === "production") return c("yellow", "PRODUCTION");
+  if (mode === "test") return c("cyan", "TEST");
+  return c("green", "DEVELOPMENT");
+}
+function printStartupBanner(opts) {
+  const {
+    title,
+    version,
+    sections,
+    width = 50,
+    labelWidth = 28,
+    locale = "ko-KR",
+    timeZone = "Asia/Seoul"
+  } = opts;
+  const bar = c("cyan", "\u2501".repeat(width));
+  console.log(`
+${bar}`);
+  console.log(`${c("bright", title)}${version ? " " + c("dim", `v${version}`) : ""}`);
+  console.log(bar);
+  for (const s of sections) {
+    console.log(`
+${s.emoji} ${c("bright", s.title)}`);
+    for (const [label, value] of s.lines) {
+      console.log(`  ${c("dim", label.padEnd(labelWidth))} ${value}`);
+    }
+  }
+  console.log(`
+${bar}`);
+  const time = (/* @__PURE__ */ new Date()).toLocaleTimeString(locale, { timeZone });
+  console.log(`${c("green", "\u2713")} Ready at ${time}`);
+  console.log(`${bar}
+`);
+}
+export {
+  c,
+  feature,
+  mask,
+  modeLabel,
+  printStartupBanner,
+  status
+};

package/dist/initialize.js

@@ -1,6 +1,9 @@
 import {
   initializeStorage
 } from "./chunk-C5CBJC6V.js";
+import {
+  initializeGeolocation
+} from "./chunk-CRJUFA73.js";
 import {
   config,
   resetConfig
@@ -8,9 +11,6 @@ import {
 import {
   initializeCors
 } from "./chunk-7ZO5UNTJ.js";
-import {
-  initializeGeolocation
-} from "./chunk-CRJUFA73.js";
 import {
   initializeLogger
 } from "./chunk-IKZB26SK.js";
@@ -19,12 +19,12 @@ import {
 } from "./chunk-TQMQ5XXG.js";
 import "./chunk-7YWUKMZD.js";
 import "./chunk-OVOBSYR4.js";
-import {
-  initializeCommon
-} from "./chunk-PX535BHW.js";
 import {
   initializeCache
 } from "./chunk-RHYETIUR.js";
+import {
+  initializeCommon
+} from "./chunk-PX535BHW.js";
 import "./chunk-ERFD6YAW.js";
 import "./chunk-6J2EJVND.js";
 import "./chunk-F3R3UYBF.js";

package/dist/next/auth-handlers/index.js

@@ -1,20 +1,3 @@
-import {
-  createLogoutHandler
-} from "../../chunk-6E2Q27EN.js";
-import {
-  createMeHandler
-} from "../../chunk-AWFP2KAU.js";
-import {
-  createOAuthAuthorizeHandler
-} from "../../chunk-U2TGXJ3A.js";
-import {
-  createOAuthCallbackHandler
-} from "../../chunk-2SV6VZOC.js";
-import "../../chunk-MTZXWVW3.js";
-import {
-  createRefreshHandler
-} from "../../chunk-RWN47K7J.js";
-import "../../chunk-XAGPZLRK.js";
 import {
   createRegisterHandler
 } from "../../chunk-RWCPRPEP.js";
@@ -33,15 +16,32 @@ import "../../chunk-75UDFONR.js";
 import {
   createLoginHandler
 } from "../../chunk-5MPMPXIR.js";
-import "../../chunk-P7WHMKN5.js";
+import {
+  createLogoutHandler
+} from "../../chunk-6E2Q27EN.js";
+import {
+  createMeHandler
+} from "../../chunk-AWFP2KAU.js";
+import {
+  createOAuthAuthorizeHandler
+} from "../../chunk-ZVGEGDYF.js";
+import {
+  createOAuthCallbackHandler
+} from "../../chunk-AQQ7JSS5.js";
+import "../../chunk-MTZXWVW3.js";
+import {
+  createRefreshHandler
+} from "../../chunk-RWN47K7J.js";
+import "../../chunk-XAGPZLRK.js";
+import "../../chunk-ZZABL54F.js";
+import "../../chunk-V3GEYUBG.js";
 import "../../chunk-CDALZTPN.js";
+import "../../chunk-HIZ7USIF.js";
 import "../../chunk-GF3DKZIW.js";
 import "../../chunk-65HVR74O.js";
 import "../../chunk-33RIHX7O.js";
 import "../../chunk-GSSHHVHF.js";
-import "../../chunk-HIZ7USIF.js";
 import "../../chunk-JLRMET4V.js";
-import "../../chunk-ZZABL54F.js";
 import "../../chunk-GH3U4WRE.js";
 import "../../chunk-LWHLB2Y6.js";
 import "../../chunk-5GWGARXI.js";

package/dist/next/auth-handlers/oauth-authorize.handler.js

@@ -1,13 +1,13 @@
 import {
   createOAuthAuthorizeHandler
-} from "../../chunk-U2TGXJ3A.js";
-import "../../chunk-P7WHMKN5.js";
+} from "../../chunk-ZVGEGDYF.js";
+import "../../chunk-V3GEYUBG.js";
 import "../../chunk-CDALZTPN.js";
+import "../../chunk-HIZ7USIF.js";
 import "../../chunk-GF3DKZIW.js";
 import "../../chunk-65HVR74O.js";
 import "../../chunk-33RIHX7O.js";
 import "../../chunk-GSSHHVHF.js";
-import "../../chunk-HIZ7USIF.js";
 import "../../chunk-JLRMET4V.js";
 import "../../chunk-GH3U4WRE.js";
 import "../../chunk-5GWGARXI.js";

package/dist/next/auth-handlers/oauth-callback.handler.js

@@ -1,14 +1,14 @@
 import {
   createOAuthCallbackHandler
-} from "../../chunk-2SV6VZOC.js";
+} from "../../chunk-AQQ7JSS5.js";
 import "../../chunk-MTZXWVW3.js";
-import "../../chunk-P7WHMKN5.js";
+import "../../chunk-V3GEYUBG.js";
 import "../../chunk-CDALZTPN.js";
+import "../../chunk-HIZ7USIF.js";
 import "../../chunk-GF3DKZIW.js";
 import "../../chunk-65HVR74O.js";
 import "../../chunk-33RIHX7O.js";
 import "../../chunk-GSSHHVHF.js";
-import "../../chunk-HIZ7USIF.js";
 import "../../chunk-JLRMET4V.js";
 import "../../chunk-GH3U4WRE.js";
 import "../../chunk-LWHLB2Y6.js";

package/dist/next/error/index.js

@@ -8,6 +8,7 @@ import {
 import {
   LocaleDetector
 } from "../../chunk-K2PNAQI4.js";
+import "../../chunk-MCPPJI3T.js";
 import {
   extractErrorInfo
 } from "../../chunk-6HQ5JHL4.js";
@@ -17,7 +18,6 @@ import {
 import "../../chunk-7WG7XPXC.js";
 import "../../chunk-AMZWDLJ4.js";
 import "../../chunk-VUYS3SU7.js";
-import "../../chunk-MCPPJI3T.js";
 import "../../chunk-5VZIAXO2.js";
 import "../../chunk-QAIN3WNN.js";
 import "../../chunk-5GWGARXI.js";

package/dist/next/middleware/error-handler.js

@@ -1,11 +1,11 @@
 import {
   errorHandlerMiddleware
-} from "../../chunk-LFJ24NDO.js";
+} from "../../chunk-A6NIKJX5.js";
 import "../../chunk-NHFIOK2D.js";
+import "../../chunk-MCPPJI3T.js";
 import "../../chunk-7WG7XPXC.js";
 import "../../chunk-AMZWDLJ4.js";
 import "../../chunk-VUYS3SU7.js";
-import "../../chunk-MCPPJI3T.js";
 import "../../chunk-5VZIAXO2.js";
 import "../../chunk-QAIN3WNN.js";
 import "../../chunk-5GWGARXI.js";

package/dist/next/middleware/index.js

@@ -4,12 +4,7 @@ import {
   withCustomApi,
   withOptionalAuthApi,
   withPublicApi
-} from "../../chunk-NT6URT4W.js";
-import {
-  createRateLimitMiddleware,
-  rateLimitMiddleware,
-  setRateLimitAdapter
-} from "../../chunk-M4ZVQFOH.js";
+} from "../../chunk-YOIZUVRD.js";
 import {
   responseLoggerMiddleware
 } from "../../chunk-LCYDMYZS.js";
@@ -32,19 +27,24 @@ import {
 } from "../../chunk-37VGD4VX.js";
 import {
   errorHandlerMiddleware
-} from "../../chunk-LFJ24NDO.js";
+} from "../../chunk-A6NIKJX5.js";
 import {
   initRequestMiddleware
 } from "../../chunk-VC2E6KYQ.js";
 import {
   MiddlewareChain
 } from "../../chunk-WXOWI7BJ.js";
+import {
+  createRateLimitMiddleware,
+  rateLimitMiddleware,
+  setRateLimitAdapter
+} from "../../chunk-M4ZVQFOH.js";
 import "../../chunk-NHFIOK2D.js";
 import "../../chunk-K2PNAQI4.js";
+import "../../chunk-MCPPJI3T.js";
 import "../../chunk-7WG7XPXC.js";
 import "../../chunk-AMZWDLJ4.js";
 import "../../chunk-VUYS3SU7.js";
-import "../../chunk-MCPPJI3T.js";
 import "../../chunk-5VZIAXO2.js";
 import "../../chunk-QAIN3WNN.js";
 import "../../chunk-LWHLB2Y6.js";

package/dist/next/middleware/wrappers.js

@@ -4,21 +4,21 @@ import {
   withCustomApi,
   withOptionalAuthApi,
   withPublicApi
-} from "../../chunk-NT6URT4W.js";
-import "../../chunk-M4ZVQFOH.js";
+} from "../../chunk-YOIZUVRD.js";
 import "../../chunk-LCYDMYZS.js";
 import "../../chunk-Y4WPEIKW.js";
 import "../../chunk-7Q6SMNMN.js";
 import "../../chunk-37VGD4VX.js";
-import "../../chunk-LFJ24NDO.js";
+import "../../chunk-A6NIKJX5.js";
 import "../../chunk-VC2E6KYQ.js";
 import "../../chunk-WXOWI7BJ.js";
+import "../../chunk-M4ZVQFOH.js";
 import "../../chunk-NHFIOK2D.js";
 import "../../chunk-K2PNAQI4.js";
+import "../../chunk-MCPPJI3T.js";
 import "../../chunk-7WG7XPXC.js";
 import "../../chunk-AMZWDLJ4.js";
 import "../../chunk-VUYS3SU7.js";
-import "../../chunk-MCPPJI3T.js";
 import "../../chunk-5VZIAXO2.js";
 import "../../chunk-QAIN3WNN.js";
 import "../../chunk-LWHLB2Y6.js";

package/dist/next/utils/index.js

@@ -1,26 +1,3 @@
-import {
-  boolFormatter,
-  createCsvHeader,
-  createSimpleCsvResponse,
-  createStreamingCsvResponse,
-  dateFormatter,
-  escapeCsvField,
-  rowToCsv
-} from "../../chunk-DVCGAI5N.js";
-import {
-  ErrorProcessor,
-  errorToResponse,
-  handlePrismaError,
-  processError,
-  throwBadRequestError,
-  throwBusinessRuleError,
-  throwConflictError,
-  throwForbiddenError,
-  throwNotFoundError,
-  throwUnauthorizedError,
-  throwValidationError,
-  withErrorHandling
-} from "../../chunk-D4QADM6T.js";
 import {
   createPaginatedResponse,
   getReferer,
@@ -45,6 +22,29 @@ import {
   withPublicCORS,
   withRestrictedCORS
 } from "../../chunk-34L7HTM7.js";
+import {
+  boolFormatter,
+  createCsvHeader,
+  createSimpleCsvResponse,
+  createStreamingCsvResponse,
+  dateFormatter,
+  escapeCsvField,
+  rowToCsv
+} from "../../chunk-DVCGAI5N.js";
+import {
+  ErrorProcessor,
+  errorToResponse,
+  handlePrismaError,
+  processError,
+  throwBadRequestError,
+  throwBusinessRuleError,
+  throwConflictError,
+  throwForbiddenError,
+  throwNotFoundError,
+  throwUnauthorizedError,
+  throwValidationError,
+  withErrorHandling
+} from "../../chunk-D4QADM6T.js";
 import "../../chunk-MCPPJI3T.js";
 import "../../chunk-5VZIAXO2.js";
 import "../../chunk-QAIN3WNN.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@withwiz/toolkit",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "Shared utility library for withwiz projects",
   "license": "MIT",
   "private": false,
@@ -151,6 +151,7 @@
     "./core/utils/optimistic-lock": "./dist/core/utils/optimistic-lock.js",
     "./core/utils/sanitizer": "./dist/core/utils/sanitizer.js",
     "./core/utils/short-code-generator": "./dist/core/utils/short-code-generator.js",
+    "./core/utils/startup-banner": "./dist/core/utils/startup-banner.js",
     "./core/utils/timezone": "./dist/core/utils/timezone.js",
     "./core/utils/type-guards": "./dist/core/utils/type-guards.js",
     "./core/utils/url-normalizer": "./dist/core/utils/url-normalizer.js",

package/dist/{chunk-LFJ24NDO.js → chunk-A6NIKJX5.js}

@@ -1,12 +1,12 @@
 import {
   AUTH_ERROR_CODE_MAP
 } from "./chunk-NHFIOK2D.js";
-import {
-  getErrorMessage
-} from "./chunk-7WG7XPXC.js";
 import {
   AppError
 } from "./chunk-MCPPJI3T.js";
+import {
+  getErrorMessage
+} from "./chunk-7WG7XPXC.js";
 import {
   ERROR_CODES,
   classifyError

package/dist/{chunk-B2JZPUQ3.js → chunk-L4WQRYMR.js}

@@ -7,12 +7,12 @@ import {
 import {
   getAuthConfig
 } from "./chunk-TQMQ5XXG.js";
-import {
-  getCommonConfig
-} from "./chunk-PX535BHW.js";
 import {
   getResolvedCacheConfig
 } from "./chunk-RHYETIUR.js";
+import {
+  getCommonConfig
+} from "./chunk-PX535BHW.js";
 
 // src/core/system/environment.ts
 import os from "os";

package/dist/{chunk-VDRLJU6C.js → chunk-Q5RPNLET.js}

@@ -1,15 +1,15 @@
-import {
-  IPApiProvider
-} from "./chunk-E27YZK7O.js";
-import {
-  IPApiCoProvider
-} from "./chunk-MRNRC45L.js";
 import {
   IPGeolocationProvider
 } from "./chunk-GJYHMHTU.js";
 import {
   MaxMindProvider
 } from "./chunk-R463CTX4.js";
+import {
+  IPApiProvider
+} from "./chunk-E27YZK7O.js";
+import {
+  IPApiCoProvider
+} from "./chunk-MRNRC45L.js";
 
 // src/core/geolocation/providers/index.ts
 var GeoIPProviderFactory = class {

package/dist/{chunk-BPDYEB37.js → chunk-UGLEAXTY.js}

@@ -1,9 +1,9 @@
-import {
-  getCommonConfig
-} from "./chunk-PX535BHW.js";
 import {
   getResolvedCacheConfig
 } from "./chunk-RHYETIUR.js";
+import {
+  getCommonConfig
+} from "./chunk-PX535BHW.js";
 
 // src/core/cache/cache-env.ts
 function _getNodeEnv() {

package/dist/{chunk-P7WHMKN5.js → chunk-V3GEYUBG.js}

@@ -1,3 +1,6 @@
+import {
+  GitHubOAuthProvider
+} from "./chunk-HIZ7USIF.js";
 import {
   GoogleOAuthProvider
 } from "./chunk-GF3DKZIW.js";
@@ -10,9 +13,6 @@ import {
 import {
   MicrosoftOAuthProvider
 } from "./chunk-GSSHHVHF.js";
-import {
-  GitHubOAuthProvider
-} from "./chunk-HIZ7USIF.js";
 import {
   OAuthError
 } from "./chunk-5GWGARXI.js";