@things-factory/shell 10.0.0-zeta.3 → 10.0.0

package/client/entries/public/home.js

@@ -83,7 +83,7 @@ export class HomePage extends LitElement {
       var descriptionMeta = document.querySelector('meta[name="application-description"]')
 
       this._applicationMeta = {
-        icon: iconLink ? iconLink.href : logo,
+        icon: iconLink ? iconLink.href : undefined,
         title: titleMeta ? titleMeta.content : 'Things Factory',
         description: descriptionMeta ? descriptionMeta.content : 'Reimagining Software'
       }

package/client/themes/app-theme.css

@@ -12,7 +12,10 @@ body {
 
   /* common style */
   --border-radius: 4px;
-  --border-dim-color: 1px solid rgba(0, 0, 0, 0.15);
+  /* 라이트/다크 모두 대비되는 캐럿 — 별도 .dark override 불필요 */
+  caret-color: var(--md-sys-color-on-surface);
+
+  --border-dim-color: 1px solid var(--md-sys-color-outline-variant);
   --border-light-color: 1px solid rgba(255, 255, 255, 0.3);
 
   --box-shadow: 2px 2px 3px 0px rgba(0, 0, 0, 0.1);
@@ -40,7 +43,6 @@ body {
   --title-margin: var(--margin-narrow) 0;
   --title-font: bold 24px var(--theme-font);
   --title-text-color: var(--md-sys-color-secondary);
-  --title-font-mobile: bold 20px var(--theme-font);
 
   --page-description-margin: var(--margin-narrow) 0 var(--margin-wide) 0;
   --page-description-font: normal var(--fontsize-default) / 1.2rem var(--theme-font);
@@ -54,19 +56,9 @@ body {
   /* icon style */
   --icon-tiny-size: var(--icon-size-medium, 24px);
   --icon-default-size: var(--icon-size-large, 32px);
-  --icon-big-size: var(--icon-size-huge, 48px);
-  --icon-default-color: var(--md-sys-color-on-primary);
 
   /* material design component themes */
-  --mdc-theme-on-primary: var(--md-sys-color-on-primary);
-  --mdc-theme-primary: var(--secondary-text-color);
-  --mdc-theme-on-secondary: var(--md-sys-color-on-primary);
-  --mdc-theme-secondary: var(--md-sys-color-primary);
-  --mdc-button-outline-color: var(--md-sys-color-primary);
   --mdc-danger-button-primary-color: var(--status-danger-color);
-  --mdc-danger-button-outline-color: var(--status-danger-color);
-  --mdc-button-outline-width: 1px;
-  --mdc-button-horizontal-padding: 16px;
 
   /* button style */
   --button-background-color: var(--md-sys-color-surface-variant);
@@ -81,8 +73,6 @@ body {
   --button-active-box-shadow: 1px 1px 1px 0px rgba(0, 0, 0, 0.2);
   --button-activ-border: 1px solid var(--md-sys-color-primary);
   --button-activ-background-color: var(--md-sys-color-primary);
-  --button-activ-color: var(--md-sys-color-on-primary);
-  --iconbtn-padding: var(--padding-narrow);
 
   --button-primary-background-color: var(--md-sys-color-primary);
   --button-primary-active-background-color: var(--status-success-color);
@@ -99,9 +89,9 @@ body {
 
   --tr-background-color: var(--md-sys-color-surface-variant);
   --tr-background-odd-color: rgba(255, 255, 255, 0.4);
-  --tr-background-hover-color: #e1f5fe;
-  --td-border-line: 1px solid rgba(0, 0, 0, 0.05);
-  --td-border-bottom: 1px solid rgba(0, 0, 0, 0.09);
+  --tr-background-hover-color: var(--md-sys-color-secondary-container);
+  --td-border-line: 1px solid var(--md-sys-color-outline-variant);
+  --td-border-bottom: 1px solid var(--md-sys-color-outline-variant);
   --td-padding: var(--padding-default);
   --td-font: normal 13px var(--theme-font);
   --td-color: var(--md-sys-color-secondary);
@@ -114,10 +104,9 @@ body {
   --label-text-transform: capitalize;
   --input-margin: var(--margin-narrow) 0;
   --input-padding: 6px 2px;
-  --input-min-width: 200px;
   --input-font: normal var(--fontsize-default) var(--theme-font);
   --input-hint-font: normal var(--fontsize-small) var(--theme-font);
-  --input-hint-color: #666;
+  --input-hint-color: var(--md-sys-color-on-surface-variant);
   --input-container-max-width: 900px;
   --fieldset-margin: var(--padding-wide) 0;
   --fieldset-padding: 0 var(--padding-wide) var(--padding-wide) var(--padding-wide);
@@ -126,12 +115,7 @@ body {
   --legend-font: bold 16px var(--theme-font);
 }
 
-body.dark {
-  caret-color: white;
-}
-
 html {
-  --scene-theme-font-family: 'Roboto', Helvetica;
 }
 
 @media only screen and (max-width: 460px) {

package/client/themes/calendar-theme.css

@@ -1,8 +1,6 @@
 body {
-  --ox-calendar-padding: var(--padding-default);
 
   /* monthly common color */
-  --calendar-monthly-text-color: var(--md-sys-color-secondary);
   --calendar-monthly-border: 1px solid rgba(0, 0, 0, 0.1);
   --calendar-monthly-border-width: 0 1px 1px 0px;
 
@@ -13,7 +11,6 @@ body {
   --calendar-current-month-color: var(--md-sys-color-on-surface);
   --calendar-monthly-label-align: left;
   --calendar-monthly-label-padding: var(--padding-narrow) 0;
-  --calendar-monthly-label-color: var(--md-sys-color-secondary);
   --calendar-monthly-opacity: 0.5;
   --calendar-monthly-date-label-background-color: var(--status-danger-color);
   --calendar-monthly-date-label-margin: var(--margin-narrow);
@@ -21,7 +18,6 @@ body {
   --calendar-monthly-date-label-color: var(--md-sys-color-on-primary);
 
   --calendar-monthly-background-color: #f4f4f4;
-  --calendar-monthly-event-border-radius: var(--border-radius);
   --calendar-monthly-event-margin: var(--padding-narrow) 0 0 0;
   --calendar-monthly-event-padding: 2px var(--padding-default);
   --calendar-monthly-event-border: 3px solid #ccc;
@@ -39,7 +35,6 @@ body {
   --calendar-current-week-color: var(--md-sys-color-on-surface);
   --calendar-weekly-label-align: center;
   --calendar-weekly-label-padding: var(--padding-narrow) 0;
-  --calendar-weekly-label-color: var(--md-sys-color-secondary);
   --calendar-weekly-opacity: 0.5;
   --calendar-weekly-date-label-background-color: var(--status-danger-color);
   --calendar-weekly-date-label-margin: var(--margin-narrow);
@@ -47,7 +42,6 @@ body {
   --calendar-weekly-date-label-color: var(--md-sys-color-on-primary);
 
   --calendar-weekly-background-color: #f4f4f4;
-  --calendar-weekly-event-border-radius: var(--border-radius);
   --calendar-weekly-event-margin: var(--padding-narrow) 0 0 0;
   --calendar-weekly-event-padding: 2px var(--padding-default);
   --calendar-weekly-event-border: 3px solid #ccc;
@@ -56,6 +50,5 @@ body {
 
 @media only screen and (max-width: 460px) {
   body {
-    --calendar-monthly-text-color: tomato;
   }
 }

package/client/themes/grist-theme.css

@@ -1,5 +1,6 @@
 body {
-  --grid-container-border-color: 1px solid rgba(0, 0, 0, 0.09);
+  /* 토큰 파생 — 라이트/다크가 자동 정합되므로 별도 .dark override 불필요 */
+  --grid-container-border-color: 1px solid var(--md-sys-color-outline-variant);
   --grid-container-border-width: 1px 0;
   --grid-wrap-container-border: 0px solid transparent;
   --grid-wrap-container-border-width: 0;
@@ -9,7 +10,6 @@ body {
   --grist-title-border: none;
   --grist-title-font: var(--md-sys-typescale-label-large-weight, var(--md-ref-typeface-weight-medium, 500)) 1.1em
     var(--theme-font, 'Roboto');
-  --grist-title-color: var(--md-sys-color-on-surface);
   --grist-title-icon-color: var(--md-sys-color-on-surface-variant);
   --grist-title-icon-margin: 0 3px 2px 0;
   --grist-title-icon-size: var(--md-sys-typescale-label-large-size, 0.875rem);
@@ -18,15 +18,14 @@ body {
   --grist-object-editor-font: normal 1em var(--theme-font, 'Roboto');
   --grist-object-editor-color: var(--md-sys-color-on-surface);
 
-  --grist-input-progress-border: 1px solid rgba(255, 255, 255, 0.5);
-  --grist-input-progress-background: rgba(121, 110, 110, 0.1);
-  --grist-input-progress-bar-background: var(--md-sys-color-primary-fixed-dim);
+  --grist-input-progress-border: 1px solid var(--md-sys-color-outline-variant);
+  --grist-input-progress-background: var(--md-sys-color-surface-container-high);
+  --grist-input-progress-bar-background: var(--md-sys-color-primary-container);
   --grist-input-progress-bar-color: var(--md-sys-color-on-surface-variant);
 
   --grid-header-background-color: var(--md-sys-color-surface-container-low);
   --grid-header-top-border: 2px solid var(--md-sys-color-primary);
   --grid-header-bottom-border: var(--grid-container-border-color);
-  --grid-header-border-color: var(--md-sys-color-outline);
   --grid-header-padding: var(--spacing-small) var(--spacing-tiny);
   --grid-header-sorter-size: 18px;
   --grid-header-splitter-border: var(--grid-container-border-color);
@@ -46,16 +45,14 @@ body {
   --grid-record-odd-background-color: var(--md-sys-color-surface-container-low);
   --grid-record-padding: var(--spacing-small) var(--spacing-medium);
   --grid-record-color: var(--md-sys-color-on-surface-variant);
-  --grid-record-color-hover: var(--md-sys-color-primary);
   --grid-record-wide-fontsize: var(--md-sys-typescale-label-large-size, 0.875rem);
   --grid-record-selected-background-color: var(--md-sys-color-primary-container);
   --grid-record-selected-color: var(--md-sys-color-on-primary-container);
-  --grid-record-focused-border: 1px solid var(--md-sys-color-outline-variant);
-  --grid-record-focused-cell-background-color: var(--md-sys-color-secondary-container);
   --grid-record-focused-cell-border: 1px dashed var(--md-sys-color-outline);
   --grid-record-focused-box-shadow: 0px 2px 0px 0px rgb(0 0 0 / 10%);
-  --grid-record-emphasized-background-color: var(--md-sys-color-secondary-fixed-dim);
-  --grid-record-emphasized-color: var(--md-sys-color-on-secondary-fixed-variant);
+  /* -fixed 는 라이트/다크 동일(고정)이라 다크에서 잔존 → 적응형 -container 짝으로 */
+  --grid-record-emphasized-background-color: var(--md-sys-color-secondary-container);
+  --grid-record-emphasized-color: var(--md-sys-color-on-secondary-container);
   --grid-record-editing-background-color: var(--md-sys-color-inverse-primary);
   --grid-record-editing-border: 1px dashed rgba(var(--md-sys-color-primary-rgb), 0.4);
   --grid-record-fontsize: var(--md-sys-typescale-label-large-size, 0.875rem);
@@ -70,13 +67,11 @@ body {
   --grid-footer-background-color: var(--md-sys-color-surface-container-low);
   --grid-footer-font-size: var(--md-sys-typescale-label-large-size, 0.875rem);
   --grid-footer-color: var(--md-sys-color-primary);
-  --grid-footer-limit-color: var(--md-ref-palette-neutral40, #5f5f5f);
-  --grid-footer-inactive-color: var(--md-ref-palette-neutral40, #5f5f5f);
+  --grid-footer-limit-color: var(--md-sys-color-on-surface-variant);
+  --grid-footer-inactive-color: var(--md-sys-color-on-surface-variant);
   --grid-footer-padding: var(--spacing-small) var(--spacing-medium);
 
   --data-list-background-color: var(--md-sys-color-surface-container-lowest);
-  --data-list-item-margin: var(--spacing-medium);
-  --data-list-item-padding: var(--spacing-medium) var(--spacing-large);
   --data-list-item-border-bottom: var(--grid-container-border-color);
   --data-list-item-name-font: bold 1.1em var(--theme-font, 'Roboto');
   --data-list-item-name-color: var(--md-sys-color-secondary);
@@ -84,47 +79,34 @@ body {
   --data-list-item-disc-color: var(--md-sys-color-on-tertiary-container);
   --data-list-item-etc-label-font: bold 1em/1em var(--theme-font, 'Roboto');
   --data-list-item-etc-font: normal 0.9em/1em var(--theme-font, 'Roboto');
-  --data-list-item-etc-color: var(--md-ref-palette-neutral50, #787878);
-  --data-list-item-icon-font: normal 1em/1em;
-  --data-list-item-icon-color: var(--md-sys-color-on-secondary);
+  --data-list-item-etc-color: var(--md-sys-color-on-surface-variant);
   --data-list-selected-background-color: var(--grid-record-selected-background-color);
   --data-list-fab-position-horizontal: 15px;
   --data-list-fab-position-vertical: 15px;
   --data-list-fab-color: var(--md-sys-color-primary);
   --data-list-fab-shadow: var(--box-shadow);
 
-  --data-card-background-color: var(--md-sys-color-surface-container);
   --data-card-record-card-background-color: var(--md-sys-color-surface-container-lowest);
   --data-card-record-card-border: var(--grid-container-border-color);
   --data-card-record-card-border-hover: 1px solid var(--md-sys-color-primary);
   --data-card-record-card-boxshadow-hover: 1px 1px 2px 1px rgba(0, 0, 0, 0.15);
-  --data-card-record-card-selected-border: 1px solid var(--md-sys-color-primary);
   --data-card-record-card-border-radius: var(--md-sys-shape-corner-medium);
   --data-card-item-margin: var(--spacing-medium);
-  --data-card-item-padding: var(--spacing-medium) var(--spacing-large);
-  --data-card-item-border-bottom: var(--grid-container-border-color);
   --data-card-item-name-font: bold 1.1em var(--theme-font, 'Roboto');
   --data-card-item-name-color: var(--md-sys-color-secondary);
-  --data-card-item-name-label-font: normal 0.65em/0.8em var(--theme-font, 'Roboto');
-  --data-card-item-name-label-color: var(--md-sys-color-secondary);
   --data-card-item-disc-font: normal 0.9em var(--theme-font, 'Roboto');
   --data-card-item-disc-color: var(--md-sys-color-tertiary);
   --data-card-item-etc-label-font: normal 1em/1em var(--theme-font, 'Roboto');
   --data-card-item-etc-font: normal 0.9em/1em var(--theme-font, 'Roboto');
-  --data-card-item-etc-color: var(--md-ref-palette-neutral50, #787878);
-  --data-card-item-icon-font: normal 1em/1em;
-  --data-card-item-icon-color: var(--md-sys-color-on-secondary);
+  --data-card-item-etc-color: var(--md-sys-color-on-surface-variant);
   --data-card-item-btn-border: var(--grid-container-border-color);
   --data-card-item-btn-border-radius: var(--md-sys-shape-corner-small);
   --data-card-item-btn-padding: var(--spacing-small);
-  --data-card-selected-background-color: var(--grid-record-selected-background-color);
   --data-card-fab-position-horizontal: 15px;
   --data-card-fab-position-vertical: 15px;
   --data-card-fab-color: var(--md-sys-color-primary);
   --data-card-fab-shadow: var(--box-shadow);
   --data-card-thumbnail-height: 140px;
-  --data-card-thumbnail-border-bottom: var(--grid-container-border-color);
-  --data-card-attachimg-height: 70px;
 
   --record-view-background-color: var(--md-sys-color-surface-container);
   --record-view-gap: var(--spacing-small) 0;
@@ -140,12 +122,10 @@ body {
   --record-view-edit-border-bottom: 2px solid var(--md-sys-color-primary);
   --record-view-item-padding: var(--spacing-medium);
 
-  --record-view-footer-background: var(--md-ref-palette-neutral50, #787878);
+  --record-view-footer-background: var(--md-sys-color-on-surface-variant);
   --record-view-footer-button-border: var(--grid-container-border-color);
   --record-view-footer-button-border-width: 0 0 0 1px;
-  --record-view-footer-button-font: 17px;
   --record-view-footer-button-color: var(--md-sys-color-surface);
-  --record-view-footer-iconbutton-size: 35px;
   --record-view-footer-focus-background: var(--md-sys-color-primary);
 
   --ox-grist-padding: var(--spacing-medium);
@@ -166,10 +146,6 @@ body {
 }
 @media (min-width: 461px) and (max-width: 1024px) {
   body {
-    --data-card-create-form-padding: 7px;
   }
 }
 
-body.dark {
-  --grid-container-border-color: 1px solid rgba(255, 255, 255, 0.09);
-}

package/client/themes/layout-theme.css

@@ -1,6 +1,5 @@
 body {
   --header-bar-background-color: var(--md-sys-color-primary);
-  --header-bar-icon-size: var(--icon-default-size);
   --header-bar-title: bold 17.5px var(--theme-font);
   --header-bar-color: var(--md-sys-color-on-primary);
   --header-bar-height: 42px;
@@ -11,18 +10,7 @@ body {
   --group-bar-textbutton: 16px/32px var(--theme-font);
   --group-bar-textbutton-active: bold var(--group-bar-textbutton);
   --group-bar-active-line-color: var(--md-sys-color-on-secondary-container);
-  --group-bar-line: solid 3px rgba(0, 0, 0, 0.2);
-
-  --footer-bar-border-top: 1px solid rgba(0, 0, 0, 0.2);
-
-  --aside-background-color: var(--md-sys-color-secondary-container);
-  --aside-list-textbtton: 18px var(--theme-font);
-  --aside-list-icon: var(--icon-default-size);
-  --aside-list-bottom-line: var(--md-sys-color-outline);
-  --aside-list-detail-background-color: #fff;
-  --aside-list-detail-text: 14px var(--md-sys-color-on-secondary-container);
-
-  --footer-bar-border-top: 1px solid rgba(0, 0, 0, 0.2);
+  --group-bar-line: solid 3px var(--md-sys-color-outline);
 
   --button-container-margin: inintial;
   --button-container-padding: 0 var(--padding-default) var(--padding-wide) var(--padding-default);
@@ -32,8 +20,6 @@ body {
   --button-container-button-background-color: var(--md-sys-color-secondary);
   --button-container-button-border-radius: var(--button-border-radius);
   --button-container-button-margin: var(--button-margin);
-  --button-container-button-font: bold var(--fontsize-large) var(--theme-font);
-  --button-container-button-color: var(--md-sys-color-on-primary);
   --button-container-button-height: initial;
   --button-container-button-border: var(--button-border);
 
@@ -48,16 +34,10 @@ body {
   --overlay-center-normal-height: 50%;
   --overlay-center-large-width: 75%;
   --overlay-center-large-height: 75%;
-  --overlay-header-height: var(--header-bar-height);
-  --overlay-header-background-color: var(--header-bar-background-color);
-  --overlay-header-color: #fff;
-  --overlay-header-font: var(--header-bar-title);
-  --overlay-background-color: rgba(0, 0, 0, 0.5);
-  --overlay-margin-bottom: 0px;
 
   /* components - resize splitter style */
-  --splitter-background-color: rgba(0, 0, 0, 0.1);
-  --splitter-hover-background-color: rgba(0, 0, 0, 0.1);
+  --splitter-background-color: var(--md-sys-color-surface-variant);
+  --splitter-hover-background-color: var(--md-sys-color-surface-variant);
 }
 
 @media only screen and (max-width: 460px) {

package/client/themes/report-theme.css

@@ -1,17 +1,9 @@
 body {
   --report-background-color: var(--md-sys-color-background);
   --report-padding: 15px;
-  --report-title-margin: 0 0 0 10px;
-  --report-title-border: none;
-  --report-title-color: var(--md-sys-color-secondary);
-  --report-title-icon-color: var(--md-sys-color-primary);
-  --report-title-icon-margin: 0 3px 2px 0;
-  --report-title-icon-size: 14px;
-  --report-title-with-grid-padding: 0;
   --report-component-border-radius: var(--border-radius);
 
   --report-header-background-color: var(--md-sys-color-surface);
-  --report-header-border: 1px solid var(--report-header-border-color);
   --report-header-border-color: var(--md-sys-color-outline);
   --report-header-padding: 5px 0 5px 5px;
   --report-header-color: var(--secondary-text-color);
@@ -19,7 +11,6 @@ body {
   --report-header-fontsize: 13px;
 
   --report-record-background-color: #fff;
-  --report-record-odd-background-color: #f6f6f6;
   --report-record-field-padding: 7px 10px;
   --report-record-field-border-bottom: 1px solid rgba(0, 0, 0, 0.1);
   --report-record-wide-fontsize: 13px;

package/client/themes/theme-base.css

@@ -0,0 +1,30 @@
+/*
+ * theme-base — 모든 앱이 공유하는 테마 기반 규칙.
+ *
+ * [왜 이 파일이 따로 있는가]
+ * builder 의 ThemeOverridePlugin 은 테마를 **파일명 단위로 완전 대체**한다(병합이 아님).
+ * 즉 앱이 `themes/light.css` 를 가지면 shell 의 `light.css` 는 빌드에서 제외된다.
+ * 그래서 공통 규칙을 light/dark 에 넣으면 앱마다 복제해야 하고, 누락이 필연적이다.
+ * (실제로 `color-scheme` 이 6개 앱에서 누락되어 있었다.)
+ *
+ * `theme-base.css` 는 **어떤 앱도 같은 이름으로 override 하지 않는 파일**이므로 항상 번들에 포함된다.
+ * → 공통 불변 규칙은 여기 한 곳에만 두면 전 앱에 적용된다.
+ *
+ * [넣는 것]  브랜드와 무관하게 항상 성립해야 하는 규칙(테마 스킴, 공통 접근성 기본값 등)
+ * [넣지 않는 것]  브랜드 색값 — 그것은 각 앱의 `light.css` / `dark.css` 소관(49개 md-sys 슬롯)
+ *
+ * 참고: v10/UI-PILOT-THEME-CONSISTENCY.md §3.5
+ */
+
+/*
+ * UA 네이티브 표면(스크롤바·폼 컨트롤·초기 배경)을 앱 테마와 일치시킨다.
+ * 선언이 없으면 다크 테마에서 native input/textarea/select·스크롤바가 밝은 OS 크롬으로 렌더된다.
+ * 색값이 아니라 스킴 선언이므로 브랜드 팔레트와 무관하게 공통 적용 가능하다.
+ */
+.light {
+  color-scheme: light;
+}
+
+.dark {
+  color-scheme: dark;
+}

package/client/themes/tooltip-theme.css

@@ -3,9 +3,5 @@ body {
   --tooltip-background-color: rgba(0, 0, 0, 0.7);
   --tooltip-font: bold 11px var(--theme-font);
   /* 
-  --tooltip-left-positon-left: auto;
-  --tooltip-left-position-top: 7px;
-  --tooltip-left-position-right: 110%;
-  --tooltip-left-position-animation: tooltip-left 0.3s ease-out 0s 1 normal; 
   */
 }

package/dist-server/bootstrap-hooks.d.ts

@@ -0,0 +1,51 @@
+import Koa from 'koa';
+import Router from 'koa-router';
+/**
+ * 부트스트랩 훅 레지스트리 (P1: 타입드 모듈 매니페스트 — 3단계).
+ *
+ * shell 은 부트스트랩 과정에서 `process` EventEmitter 로 일련의 라이프사이클 이벤트를 emit 하고,
+ * 각 모듈은 이를 listen 해 라우터/미들웨어/구독을 등록한다. 이 파일은 그 문자열 이벤트명과
+ * 페이로드를 한곳에서 타입으로 고정한다.
+ *
+ * 원칙(하위호환):
+ * - 내부는 여전히 동일한 `process.emit/on` 을 사용한다 → 기존 136개 모듈의
+ *   `process.on('bootstrap-module-*', ...)` 는 그대로 동작한다(무변경).
+ * - shell 의 emit 측을 `emitHook` 으로 전환해 이벤트명 오타·페이로드 시그니처를 컴파일 체크한다.
+ * - 모듈은 원하면 `onHook` 으로 자발적 전환 가능(강제 아님).
+ */
+/** 부트스트랩 훅 이름 상수 (오타 방지용 단일 소스). */
+export declare const BOOTSTRAP_HOOKS: {
+    readonly moduleSubscription: "bootstrap-module-subscription";
+    readonly collectSsoMiddleware: "bootstrap-collect-sso-middleware";
+    readonly globalPublicRoute: "bootstrap-module-global-public-route";
+    readonly globalPrivateRoute: "bootstrap-module-global-private-route";
+    readonly domainPublicRoute: "bootstrap-module-domain-public-route";
+    readonly domainPrivateRoute: "bootstrap-module-domain-private-route";
+    readonly moduleStart: "bootstrap-module-start";
+    readonly clientRebuilt: "client-rebuilt";
+};
+/** module-start 훅 페이로드. */
+export interface BootstrapModuleStartPayload {
+    app: Koa;
+    config: any;
+    builtSchema: any;
+    httpServer: any;
+}
+/**
+ * 훅 이벤트명 → emit/on 인자 튜플 매핑.
+ * (동적 수집 지점인 middleware/collection 인자는 any 로 둔다.)
+ */
+export interface BootstrapHookArgs {
+    'bootstrap-module-subscription': [app: Koa, subscriptionMiddleware: any];
+    'bootstrap-collect-sso-middleware': [value: null, ssoMiddlewares: any[]];
+    'bootstrap-module-global-public-route': [app: Koa, router: Router];
+    'bootstrap-module-global-private-route': [app: Koa, router: Router];
+    'bootstrap-module-domain-public-route': [app: Koa, router: Router];
+    'bootstrap-module-domain-private-route': [app: Koa, router: Router];
+    'bootstrap-module-start': [payload: BootstrapModuleStartPayload];
+    'client-rebuilt': [app: Koa, outputFileSystem: any];
+}
+/** 부트스트랩 훅을 타입 안전하게 emit 한다(내부적으로 process.emit). */
+export declare function emitHook<K extends keyof BootstrapHookArgs>(name: K, ...args: BootstrapHookArgs[K]): void;
+/** 부트스트랩 훅을 타입 안전하게 구독한다(내부적으로 process.on). 기존 process.on 과 병존. */
+export declare function onHook<K extends keyof BootstrapHookArgs>(name: K, handler: (...args: BootstrapHookArgs[K]) => void): void;

package/dist-server/bootstrap-hooks.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BOOTSTRAP_HOOKS = void 0;
+exports.emitHook = emitHook;
+exports.onHook = onHook;
+/**
+ * 부트스트랩 훅 레지스트리 (P1: 타입드 모듈 매니페스트 — 3단계).
+ *
+ * shell 은 부트스트랩 과정에서 `process` EventEmitter 로 일련의 라이프사이클 이벤트를 emit 하고,
+ * 각 모듈은 이를 listen 해 라우터/미들웨어/구독을 등록한다. 이 파일은 그 문자열 이벤트명과
+ * 페이로드를 한곳에서 타입으로 고정한다.
+ *
+ * 원칙(하위호환):
+ * - 내부는 여전히 동일한 `process.emit/on` 을 사용한다 → 기존 136개 모듈의
+ *   `process.on('bootstrap-module-*', ...)` 는 그대로 동작한다(무변경).
+ * - shell 의 emit 측을 `emitHook` 으로 전환해 이벤트명 오타·페이로드 시그니처를 컴파일 체크한다.
+ * - 모듈은 원하면 `onHook` 으로 자발적 전환 가능(강제 아님).
+ */
+/** 부트스트랩 훅 이름 상수 (오타 방지용 단일 소스). */
+exports.BOOTSTRAP_HOOKS = {
+    moduleSubscription: 'bootstrap-module-subscription',
+    collectSsoMiddleware: 'bootstrap-collect-sso-middleware',
+    globalPublicRoute: 'bootstrap-module-global-public-route',
+    globalPrivateRoute: 'bootstrap-module-global-private-route',
+    domainPublicRoute: 'bootstrap-module-domain-public-route',
+    domainPrivateRoute: 'bootstrap-module-domain-private-route',
+    moduleStart: 'bootstrap-module-start',
+    clientRebuilt: 'client-rebuilt'
+};
+/** 부트스트랩 훅을 타입 안전하게 emit 한다(내부적으로 process.emit). */
+function emitHook(name, ...args) {
+    ;
+    process.emit(name, ...args);
+}
+/** 부트스트랩 훅을 타입 안전하게 구독한다(내부적으로 process.on). 기존 process.on 과 병존. */
+function onHook(name, handler) {
+    process.on(name, handler);
+}
+//# sourceMappingURL=bootstrap-hooks.js.map

package/dist-server/bootstrap-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap-hooks.js","sourceRoot":"","sources":["../server/bootstrap-hooks.ts"],"names":[],"mappings":";;;AAqDA,4BAEC;AAGD,wBAKC;AA5DD;;;;;;;;;;;;GAYG;AAEH,oCAAoC;AACvB,QAAA,eAAe,GAAG;IAC7B,kBAAkB,EAAE,+BAA+B;IACnD,oBAAoB,EAAE,kCAAkC;IACxD,iBAAiB,EAAE,sCAAsC;IACzD,kBAAkB,EAAE,uCAAuC;IAC3D,iBAAiB,EAAE,sCAAsC;IACzD,kBAAkB,EAAE,uCAAuC;IAC3D,WAAW,EAAE,wBAAwB;IACrC,aAAa,EAAE,gBAAgB;CACvB,CAAA;AAyBV,oDAAoD;AACpD,SAAgB,QAAQ,CAAoC,IAAO,EAAE,GAAG,IAA0B;IAChG,CAAC;IAAC,OAAe,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,CAAA;AACvC,CAAC;AAED,mEAAmE;AACnE,SAAgB,MAAM,CACpB,IAAO,EACP,OAAgD;IAEhD,OAAO,CAAC,EAAE,CAAC,IAAW,EAAE,OAAc,CAAC,CAAA;AACzC,CAAC","sourcesContent":["import Koa from 'koa'\nimport Router from 'koa-router'\n\n/**\n * 부트스트랩 훅 레지스트리 (P1: 타입드 모듈 매니페스트 — 3단계).\n *\n * shell 은 부트스트랩 과정에서 `process` EventEmitter 로 일련의 라이프사이클 이벤트를 emit 하고,\n * 각 모듈은 이를 listen 해 라우터/미들웨어/구독을 등록한다. 이 파일은 그 문자열 이벤트명과\n * 페이로드를 한곳에서 타입으로 고정한다.\n *\n * 원칙(하위호환):\n * - 내부는 여전히 동일한 `process.emit/on` 을 사용한다 → 기존 136개 모듈의\n *   `process.on('bootstrap-module-*', ...)` 는 그대로 동작한다(무변경).\n * - shell 의 emit 측을 `emitHook` 으로 전환해 이벤트명 오타·페이로드 시그니처를 컴파일 체크한다.\n * - 모듈은 원하면 `onHook` 으로 자발적 전환 가능(강제 아님).\n */\n\n/** 부트스트랩 훅 이름 상수 (오타 방지용 단일 소스). */\nexport const BOOTSTRAP_HOOKS = {\n  moduleSubscription: 'bootstrap-module-subscription',\n  collectSsoMiddleware: 'bootstrap-collect-sso-middleware',\n  globalPublicRoute: 'bootstrap-module-global-public-route',\n  globalPrivateRoute: 'bootstrap-module-global-private-route',\n  domainPublicRoute: 'bootstrap-module-domain-public-route',\n  domainPrivateRoute: 'bootstrap-module-domain-private-route',\n  moduleStart: 'bootstrap-module-start',\n  clientRebuilt: 'client-rebuilt'\n} as const\n\n/** module-start 훅 페이로드. */\nexport interface BootstrapModuleStartPayload {\n  app: Koa\n  config: any\n  builtSchema: any\n  httpServer: any\n}\n\n/**\n * 훅 이벤트명 → emit/on 인자 튜플 매핑.\n * (동적 수집 지점인 middleware/collection 인자는 any 로 둔다.)\n */\nexport interface BootstrapHookArgs {\n  'bootstrap-module-subscription': [app: Koa, subscriptionMiddleware: any]\n  'bootstrap-collect-sso-middleware': [value: null, ssoMiddlewares: any[]]\n  'bootstrap-module-global-public-route': [app: Koa, router: Router]\n  'bootstrap-module-global-private-route': [app: Koa, router: Router]\n  'bootstrap-module-domain-public-route': [app: Koa, router: Router]\n  'bootstrap-module-domain-private-route': [app: Koa, router: Router]\n  'bootstrap-module-start': [payload: BootstrapModuleStartPayload]\n  'client-rebuilt': [app: Koa, outputFileSystem: any]\n}\n\n/** 부트스트랩 훅을 타입 안전하게 emit 한다(내부적으로 process.emit). */\nexport function emitHook<K extends keyof BootstrapHookArgs>(name: K, ...args: BootstrapHookArgs[K]): void {\n  ;(process as any).emit(name, ...args)\n}\n\n/** 부트스트랩 훅을 타입 안전하게 구독한다(내부적으로 process.on). 기존 process.on 과 병존. */\nexport function onHook<K extends keyof BootstrapHookArgs>(\n  name: K,\n  handler: (...args: BootstrapHookArgs[K]) => void\n): void {\n  process.on(name as any, handler as any)\n}\n"]}

package/dist-server/index.d.ts

@@ -5,6 +5,7 @@ export * from './utils/index.js';
 export * from './pubsub.js';
 export * from './pubsub-log-transport.js';
 export * from './middlewares/index.js';
+export * from './bootstrap-hooks.js';
 export * from './graphql-local-client.js';
 export * from './service/index.js';
 export * from './typeorm/encrypt-transform.js';

package/dist-server/index.js

@@ -8,6 +8,7 @@ tslib_1.__exportStar(require("./utils/index.js"), exports);
 tslib_1.__exportStar(require("./pubsub.js"), exports);
 tslib_1.__exportStar(require("./pubsub-log-transport.js"), exports);
 tslib_1.__exportStar(require("./middlewares/index.js"), exports);
+tslib_1.__exportStar(require("./bootstrap-hooks.js"), exports);
 tslib_1.__exportStar(require("./graphql-local-client.js"), exports);
 tslib_1.__exportStar(require("./service/index.js"), exports);
 tslib_1.__exportStar(require("./typeorm/encrypt-transform.js"), exports);

package/dist-server/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../server/index.ts"],"names":[],"mappings":";;;AAAA,gEAAqC;AACrC,4EAAiD;AACjD,qEAA0C;AAC1C,2DAAgC;AAChC,sDAA2B;AAC3B,oEAAyC;AACzC,iEAAsC;AACtC,oEAAyC;AACzC,6DAAkC;AAElC,yEAA8C;AAC9C,8EAAmD;AACnD,uEAA4C;AAC5C,uEAA4C","sourcesContent":["export * from './migrations/index.js'\nexport * from './initializers/naming-strategy.js'\nexport * from './initializers/database.js'\nexport * from './utils/index.js'\nexport * from './pubsub.js'\nexport * from './pubsub-log-transport.js'\nexport * from './middlewares/index.js'\nexport * from './graphql-local-client.js'\nexport * from './service/index.js'\n\nexport * from './typeorm/encrypt-transform.js'\nexport * from './typeorm/encrypt-json-transform.js'\nexport * from './typeorm/json5-transform.js'\nexport * from './typeorm/round-transform.js'\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../server/index.ts"],"names":[],"mappings":";;;AAAA,gEAAqC;AACrC,4EAAiD;AACjD,qEAA0C;AAC1C,2DAAgC;AAChC,sDAA2B;AAC3B,oEAAyC;AACzC,iEAAsC;AACtC,+DAAoC;AACpC,oEAAyC;AACzC,6DAAkC;AAElC,yEAA8C;AAC9C,8EAAmD;AACnD,uEAA4C;AAC5C,uEAA4C","sourcesContent":["export * from './migrations/index.js'\nexport * from './initializers/naming-strategy.js'\nexport * from './initializers/database.js'\nexport * from './utils/index.js'\nexport * from './pubsub.js'\nexport * from './pubsub-log-transport.js'\nexport * from './middlewares/index.js'\nexport * from './bootstrap-hooks.js'\nexport * from './graphql-local-client.js'\nexport * from './service/index.js'\n\nexport * from './typeorm/encrypt-transform.js'\nexport * from './typeorm/encrypt-json-transform.js'\nexport * from './typeorm/json5-transform.js'\nexport * from './typeorm/round-transform.js'\n"]}

package/dist-server/initializers/database.js

@@ -80,7 +80,10 @@ const databaseInitializer = async () => {
         }
     }
     catch (e) {
-        env_1.logger.error(e);
+        /* DB 는 필수 인프라 — 초기화 실패를 삼키면 'default' DataSource 없이 부팅되어
+           이후 모든 요청이 런타임에 터진다(좀비 부팅). 실패를 전파해 즉시 중단(fail-fast)한다. */
+        env_1.logger.error('Failed to initialize database', e);
+        throw e;
     }
 };
 exports.databaseInitializer = databaseInitializer;

package/dist-server/initializers/database.js.map

@@ -1 +1 @@
-{"version":3,"file":"database.js","sourceRoot":"","sources":["../../server/initializers/database.ts"],"names":[],"mappings":";;;AAYA,sCAEC;AAOD,sCAEC;AAMD,4CAEC;AAMD,gDAEC;AAOD,sCAEC;;AAhDD,qCAA+F;AAE/F,6CAAoD;AACpD,0EAAsC;AAEtC,MAAM,WAAW,GAAmC,EAAE,CAAA;AAEtD;;;;GAIG;AACH,SAAgB,aAAa,CAAC,IAAa;IACzC,OAAO,WAAW,CAAC,IAAI,IAAI,SAAS,CAAC,CAAA;AACvC,CAAC;AAED;;;;GAIG;AACH,SAAgB,aAAa,CAAC,IAAY,EAAE,UAAsB;IAChE,WAAW,CAAC,IAAI,CAAC,GAAG,UAAU,CAAA;AAChC,CAAC;AAED;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,IAAY;IAC3C,OAAO,WAAW,CAAC,IAAI,CAAC,CAAA;AAC1B,CAAC;AAED;;;GAGG;AACH,SAAgB,kBAAkB;IAChC,OAAO,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;AACjC,CAAC;AAED;;;;GAIG;AACH,SAAgB,aAAa,CAAI,MAAuB,EAAE,EAAkB;IAC1E,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAI,MAAM,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,aAAa,CAAI,MAAM,CAAC,CAAA;AAC7F,CAAC;AAED;;GAEG;AACI,MAAM,mBAAmB,GAAG,KAAK,IAAI,EAAE;IAC5C,IAAI,CAAC;QACH,MAAM,oBAAoB,GAAG,YAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;QAEpD,MAAM,UAAU,GAAG,MAAM,IAAA,0BAAgB,EAAC;YACxC,GAAG,sBAAS;YACZ,GAAG,oBAAoB;SACxB,CAAC,CAAA;QAEF,aAAa,CAAC,SAAS,EAAE,UAAU,CAAC,CAAA;QAEpC,YAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAA;QAE7C,IAAI,oBAAoB,CAAC,IAAI,IAAI,QAAQ,IAAI,oBAAoB,CAAC,WAAW,IAAI,KAAK,EAAE,CAAC;YACvF,MAAM,UAAU,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAA;YACjD,MAAM,UAAU,CAAC,WAAW,EAAE,CAAA;YAC9B,MAAM,UAAU,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAA;QAClD,CAAC;QAED,IAAI,YAAM,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC;YAC/B,MAAM,aAAa,GAAG,IAAI,oBAAU,CAAC;gBACnC,GAAG,sBAAS;gBACZ,GAAG,YAAM,CAAC,GAAG,CAAC,cAAc,CAAC;aAC9B,CAAC,CAAA;YACF,MAAM,aAAa,CAAC,UAAU,EAAE,CAAA;YAChC,aAAa,CAAC,IAAI,EAAE,aAAa,CAAC,CAAA;YAElC,YAAM,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAA;QACnD,CAAC;aAAM,CAAC;YACN,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;QACjC,CAAC;IACH,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,YAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;AACH,CAAC,CAAA;AAlCY,QAAA,mBAAmB,uBAkC/B","sourcesContent":["import { createConnection, DataSource, EntityManager, EntityTarget, Repository } from 'typeorm'\n\nimport { config, logger } from '@things-factory/env'\nimport ormconfig from './ormconfig.js'\n\nconst dataSources: { [name: string]: DataSource } = {}\n\n/**\n * Returns the specified DataSource by name.\n * @param {string} name - The name of the DataSource.\n * @returns {DataSource} - The DataSource with the specified name.\n */\nexport function getDataSource(name?: string): DataSource {\n  return dataSources[name || 'default']\n}\n\n/**\n * Adds a new DataSource with the specified name.\n * @param {string} name - The name of the DataSource to add.\n * @param {DataSource} dataSource - The DataSource to add.\n */\nexport function addDataSource(name: string, dataSource: DataSource) {\n  dataSources[name] = dataSource\n}\n\n/**\n * Removes a DataSource with the specified name.\n * @param {string} name - The name of the DataSource to remove.\n */\nexport function removeDataSource(name: string) {\n  delete dataSources[name]\n}\n\n/**\n * Returns an array of all registered DataSource names.\n * @returns {string[]} - An array of DataSource names.\n */\nexport function getDataSourceNames() {\n  return Object.keys(dataSources)\n}\n\n/**\n * Returns a repository for the specified entity.\n * @param {EntityTarget<X>} target - The target entity for which to get the repository.\n * @returns {Repository<X>} - The repository for the specified entity.\n */\nexport function getRepository<X>(target: EntityTarget<X>, tx?: EntityManager): Repository<X> {\n  return tx ? tx.getRepository<X>(target) : getDataSource('default').getRepository<X>(target)\n}\n\n/**\n * Initializes the database connections and data sources.\n */\nexport const databaseInitializer = async () => {\n  try {\n    const readConnectionConfig = config.get('ormconfig')\n\n    const dataSource = await createConnection({\n      ...ormconfig,\n      ...readConnectionConfig\n    })\n\n    addDataSource('default', dataSource)\n\n    logger.info('Default DataSource established')\n\n    if (readConnectionConfig.type == 'sqlite' && readConnectionConfig.synchronize == false) {\n      await dataSource.query('PRAGMA foreign_keys=OFF')\n      await dataSource.synchronize()\n      await dataSource.query('PRAGMA foreign_keys=ON')\n    }\n\n    if (config.get('ormconfig4Tx')) {\n      const dataSource4Tx = new DataSource({\n        ...ormconfig,\n        ...config.get('ormconfig4Tx')\n      })\n      await dataSource4Tx.initialize()\n      addDataSource('tx', dataSource4Tx)\n\n      logger.info('Transaction DataSource established')\n    } else {\n      addDataSource('tx', dataSource)\n    }\n  } catch (e) {\n    logger.error(e)\n  }\n}\n"]}
+{"version":3,"file":"database.js","sourceRoot":"","sources":["../../server/initializers/database.ts"],"names":[],"mappings":";;;AAYA,sCAEC;AAOD,sCAEC;AAMD,4CAEC;AAMD,gDAEC;AAOD,sCAEC;;AAhDD,qCAA+F;AAE/F,6CAAoD;AACpD,0EAAsC;AAEtC,MAAM,WAAW,GAAmC,EAAE,CAAA;AAEtD;;;;GAIG;AACH,SAAgB,aAAa,CAAC,IAAa;IACzC,OAAO,WAAW,CAAC,IAAI,IAAI,SAAS,CAAC,CAAA;AACvC,CAAC;AAED;;;;GAIG;AACH,SAAgB,aAAa,CAAC,IAAY,EAAE,UAAsB;IAChE,WAAW,CAAC,IAAI,CAAC,GAAG,UAAU,CAAA;AAChC,CAAC;AAED;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,IAAY;IAC3C,OAAO,WAAW,CAAC,IAAI,CAAC,CAAA;AAC1B,CAAC;AAED;;;GAGG;AACH,SAAgB,kBAAkB;IAChC,OAAO,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;AACjC,CAAC;AAED;;;;GAIG;AACH,SAAgB,aAAa,CAAI,MAAuB,EAAE,EAAkB;IAC1E,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAI,MAAM,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,aAAa,CAAI,MAAM,CAAC,CAAA;AAC7F,CAAC;AAED;;GAEG;AACI,MAAM,mBAAmB,GAAG,KAAK,IAAI,EAAE;IAC5C,IAAI,CAAC;QACH,MAAM,oBAAoB,GAAG,YAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;QAEpD,MAAM,UAAU,GAAG,MAAM,IAAA,0BAAgB,EAAC;YACxC,GAAG,sBAAS;YACZ,GAAG,oBAAoB;SACxB,CAAC,CAAA;QAEF,aAAa,CAAC,SAAS,EAAE,UAAU,CAAC,CAAA;QAEpC,YAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAA;QAE7C,IAAI,oBAAoB,CAAC,IAAI,IAAI,QAAQ,IAAI,oBAAoB,CAAC,WAAW,IAAI,KAAK,EAAE,CAAC;YACvF,MAAM,UAAU,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAA;YACjD,MAAM,UAAU,CAAC,WAAW,EAAE,CAAA;YAC9B,MAAM,UAAU,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAA;QAClD,CAAC;QAED,IAAI,YAAM,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC;YAC/B,MAAM,aAAa,GAAG,IAAI,oBAAU,CAAC;gBACnC,GAAG,sBAAS;gBACZ,GAAG,YAAM,CAAC,GAAG,CAAC,cAAc,CAAC;aAC9B,CAAC,CAAA;YACF,MAAM,aAAa,CAAC,UAAU,EAAE,CAAA;YAChC,aAAa,CAAC,IAAI,EAAE,aAAa,CAAC,CAAA;YAElC,YAAM,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAA;QACnD,CAAC;aAAM,CAAC;YACN,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;QACjC,CAAC;IACH,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX;oEAC4D;QAC5D,YAAM,CAAC,KAAK,CAAC,+BAA+B,EAAE,CAAC,CAAC,CAAA;QAChD,MAAM,CAAC,CAAA;IACT,CAAC;AACH,CAAC,CAAA;AArCY,QAAA,mBAAmB,uBAqC/B","sourcesContent":["import { createConnection, DataSource, EntityManager, EntityTarget, Repository } from 'typeorm'\n\nimport { config, logger } from '@things-factory/env'\nimport ormconfig from './ormconfig.js'\n\nconst dataSources: { [name: string]: DataSource } = {}\n\n/**\n * Returns the specified DataSource by name.\n * @param {string} name - The name of the DataSource.\n * @returns {DataSource} - The DataSource with the specified name.\n */\nexport function getDataSource(name?: string): DataSource {\n  return dataSources[name || 'default']\n}\n\n/**\n * Adds a new DataSource with the specified name.\n * @param {string} name - The name of the DataSource to add.\n * @param {DataSource} dataSource - The DataSource to add.\n */\nexport function addDataSource(name: string, dataSource: DataSource) {\n  dataSources[name] = dataSource\n}\n\n/**\n * Removes a DataSource with the specified name.\n * @param {string} name - The name of the DataSource to remove.\n */\nexport function removeDataSource(name: string) {\n  delete dataSources[name]\n}\n\n/**\n * Returns an array of all registered DataSource names.\n * @returns {string[]} - An array of DataSource names.\n */\nexport function getDataSourceNames() {\n  return Object.keys(dataSources)\n}\n\n/**\n * Returns a repository for the specified entity.\n * @param {EntityTarget<X>} target - The target entity for which to get the repository.\n * @returns {Repository<X>} - The repository for the specified entity.\n */\nexport function getRepository<X>(target: EntityTarget<X>, tx?: EntityManager): Repository<X> {\n  return tx ? tx.getRepository<X>(target) : getDataSource('default').getRepository<X>(target)\n}\n\n/**\n * Initializes the database connections and data sources.\n */\nexport const databaseInitializer = async () => {\n  try {\n    const readConnectionConfig = config.get('ormconfig')\n\n    const dataSource = await createConnection({\n      ...ormconfig,\n      ...readConnectionConfig\n    })\n\n    addDataSource('default', dataSource)\n\n    logger.info('Default DataSource established')\n\n    if (readConnectionConfig.type == 'sqlite' && readConnectionConfig.synchronize == false) {\n      await dataSource.query('PRAGMA foreign_keys=OFF')\n      await dataSource.synchronize()\n      await dataSource.query('PRAGMA foreign_keys=ON')\n    }\n\n    if (config.get('ormconfig4Tx')) {\n      const dataSource4Tx = new DataSource({\n        ...ormconfig,\n        ...config.get('ormconfig4Tx')\n      })\n      await dataSource4Tx.initialize()\n      addDataSource('tx', dataSource4Tx)\n\n      logger.info('Transaction DataSource established')\n    } else {\n      addDataSource('tx', dataSource)\n    }\n  } catch (e) {\n    /* DB 는 필수 인프라 — 초기화 실패를 삼키면 'default' DataSource 없이 부팅되어\n       이후 모든 요청이 런타임에 터진다(좀비 부팅). 실패를 전파해 즉시 중단(fail-fast)한다. */\n    logger.error('Failed to initialize database', e)\n    throw e\n  }\n}\n"]}

package/dist-server/server-dev.js

@@ -31,6 +31,7 @@ const env_1 = require("@things-factory/env");
 const operato_license_checker_1 = require("@things-factory/operato-license-checker");
 const graphql_local_client_js_1 = require("./graphql-local-client.js");
 const database_js_1 = require("./initializers/database.js");
+const bootstrap_hooks_js_1 = require("./bootstrap-hooks.js");
 const index_js_1 = require("./routers/index.js");
 const schema_js_1 = require("./schema.js");
 const domain_middleware_js_1 = require("./middlewares/domain-middleware.js");
@@ -86,7 +87,7 @@ const bootstrap = async () => {
         await next();
     });
     var subscriptionMiddleware = [];
-    process.emit('bootstrap-module-subscription', app, subscriptionMiddleware);
+    (0, bootstrap_hooks_js_1.emitHook)('bootstrap-module-subscription', app, subscriptionMiddleware);
     const builtSchema = await (0, schema_js_1.schema)();
     const httpServer = (0, http_1.createServer)(app.callback());
     const websocketServer = new ws_2.WebSocketServer({
@@ -176,8 +177,7 @@ const bootstrap = async () => {
     });
     // only for development mode. triggered after webpack compilation is done.
     compiler.hooks.done.tap({ name: 'server-dev' }, stats => {
-        ;
-        process.emit('client-rebuilt', app, compiler.outputFileSystem);
+        (0, bootstrap_hooks_js_1.emitHook)('client-rebuilt', app, compiler.outputFileSystem);
     });
     // Skip body parser for proxy paths to allow raw body forwarding
     app.use(async (ctx, next) => {
@@ -189,12 +189,12 @@ const bootstrap = async () => {
     });
     /* routers */
     const ssoMiddlewares = [];
-    process.emit('bootstrap-collect-sso-middleware', null, ssoMiddlewares);
+    (0, bootstrap_hooks_js_1.emitHook)('bootstrap-collect-sso-middleware', null, ssoMiddlewares);
     app.ssoMiddlewares = ssoMiddlewares;
-    process.emit('bootstrap-module-global-public-route', app, index_js_1.globalPublicRouter);
-    process.emit('bootstrap-module-global-private-route', app, index_js_1.globalPrivateRouter);
-    process.emit('bootstrap-module-domain-public-route', app, index_js_1.domainPublicRouter);
-    process.emit('bootstrap-module-domain-private-route', app, index_js_1.domainPrivateRouter);
+    (0, bootstrap_hooks_js_1.emitHook)('bootstrap-module-global-public-route', app, index_js_1.globalPublicRouter);
+    (0, bootstrap_hooks_js_1.emitHook)('bootstrap-module-global-private-route', app, index_js_1.globalPrivateRouter);
+    (0, bootstrap_hooks_js_1.emitHook)('bootstrap-module-domain-public-route', app, index_js_1.domainPublicRouter);
+    (0, bootstrap_hooks_js_1.emitHook)('bootstrap-module-domain-private-route', app, index_js_1.domainPrivateRouter);
     app.use(operato_license_checker_1.checkValidity); /* Check the license after most of the context has been built */
     app
         .use(index_js_1.globalPublicRouter.routes())
@@ -220,8 +220,11 @@ const bootstrap = async () => {
     httpServer.listen({ port: PORT }, () => {
         env_1.logger.info(`🚀 Server ready at http://0.0.0.0:${PORT}/graphql`);
         env_1.logger.info(`🚀 Subscriptions ready at ws://0.0.0.0:${PORT}/graphql`);
-        process.emit('bootstrap-module-start', { app, config: env_1.config, builtSchema, httpServer });
+        (0, bootstrap_hooks_js_1.emitHook)('bootstrap-module-start', { app, config: env_1.config, builtSchema, httpServer });
     });
 };
-bootstrap();
+bootstrap().catch(error => {
+    env_1.logger.error('Failed to bootstrap server', error);
+    process.exit(1);
+});
 //# sourceMappingURL=server-dev.js.map