entity-client 1.0.7 → 1.0.9

package/dist/EntityAppServerApi.js

@@ -0,0 +1,2 @@
+import{EntityServerApi as i}from"./EntityServerApi.js";import{AccountAppMixin as n,BoardMixin as x,EmailVerifyMixin as r,OAuthMixin as t,PasswordResetMixin as M,TwoFactorMixin as o}from"./mixins/app/index.js";import{AlimtalkMixin as e,AppPushMixin as p,FriendtalkMixin as m,HolidaysMixin as a,IdentityMixin as s,LlmMixin as A,OcrMixin as l,PgMixin as c,SmsMixin as d,TaxinvoiceMixin as y}from"./mixins/app/plugins/index.js";class P extends e(m(d(p(c(y(l(A(s(a(t(o(M(r(x(n(i)))))))))))))))){}export{P as EntityAppServerApi};
+//# sourceMappingURL=EntityAppServerApi.js.map

package/dist/EntityAppServerApi.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/EntityAppServerApi.ts"],
+  "sourcesContent": ["import { EntityServerApi } from \"./EntityServerApi.js\";\nimport {\n    AccountAppMixin,\n    BoardMixin,\n    EmailVerifyMixin,\n    OAuthMixin,\n    PasswordResetMixin,\n    TwoFactorMixin,\n} from \"./mixins/app/index.js\";\nimport {\n    AlimtalkMixin,\n    AppPushMixin,\n    FriendtalkMixin,\n    HolidaysMixin,\n    IdentityMixin,\n    LlmMixin,\n    OcrMixin,\n    PgMixin,\n    SmsMixin,\n    TaxinvoiceMixin,\n} from \"./mixins/app/plugins/index.js\";\n\nexport class EntityAppServerApi extends AlimtalkMixin(\n    FriendtalkMixin(\n        SmsMixin(\n            AppPushMixin(\n                PgMixin(\n                    TaxinvoiceMixin(\n                        OcrMixin(\n                            LlmMixin(\n                                IdentityMixin(\n                                    HolidaysMixin(\n                                        OAuthMixin(\n                                            TwoFactorMixin(\n                                                PasswordResetMixin(\n                                                    EmailVerifyMixin(\n                                                        BoardMixin(\n                                                            AccountAppMixin(\n                                                                EntityServerApi,\n                                                            ),\n                                                        ),\n                                                    ),\n                                                ),\n                                            ),\n                                        ),\n                                    ),\n                                ),\n                            ),\n                        ),\n                    ),\n                ),\n            ),\n        ),\n    ),\n) {}\n"],
+  "mappings": "AAAA,OAAS,mBAAAA,MAAuB,uBAChC,OACI,mBAAAC,EACA,cAAAC,EACA,oBAAAC,EACA,cAAAC,EACA,sBAAAC,EACA,kBAAAC,MACG,wBACP,OACI,iBAAAC,EACA,gBAAAC,EACA,mBAAAC,EACA,iBAAAC,EACA,iBAAAC,EACA,YAAAC,EACA,YAAAC,EACA,WAAAC,EACA,YAAAC,EACA,mBAAAC,MACG,gCAEA,MAAMC,UAA2BV,EACpCE,EACIM,EACIP,EACIM,EACIE,EACIH,EACID,EACID,EACID,EACIN,EACIE,EACID,EACIF,EACID,EACID,EACID,CACJ,CACJ,CACJ,CACJ,CACJ,CACJ,CACJ,CACJ,CACJ,CACJ,CACJ,CACJ,CACJ,CACJ,CACJ,CACJ,CAAE,CAAC",
+  "names": ["EntityServerApi", "AccountAppMixin", "BoardMixin", "EmailVerifyMixin", "OAuthMixin", "PasswordResetMixin", "TwoFactorMixin", "AlimtalkMixin", "AppPushMixin", "FriendtalkMixin", "HolidaysMixin", "IdentityMixin", "LlmMixin", "OcrMixin", "PgMixin", "SmsMixin", "TaxinvoiceMixin", "EntityAppServerApi"]
+}

package/dist/{EntityServerClient.d.ts → EntityServerApi.d.ts}

@@ -1,5 +1,5 @@
 /**
- * @file EntityServerClient.ts
+ * @file EntityServerApi.ts
  * entity-server core route용 Mixin 조합 클라이언트.
  *
  * 절(section)별 구현:
@@ -8,7 +8,7 @@
  *   src/mixins/app/*              — entity-app-server plugin mixin
  */
 import { EntityServerClientBase } from "./client/base.js";
-declare const EntityServerClient_base: {
+declare const EntityServerApi_base: {
     new (...args: any[]): {
         addressSido<T = unknown>(): Promise<T>;
         addressSigungu<T = unknown>(query: {
@@ -43,10 +43,9 @@ declare const EntityServerClient_base: {
         hmacSecret: string;
         encryptRequests: boolean;
         csrfEnabled: boolean;
-        csrfToken: string;
         csrfHeaderName: string;
-        csrfRefreshPath: string;
-        csrfRefreshBuffer: number;
+        csrfCookieName: string;
+        _csrfRefresher: (() => Promise<void>) | null;
         activeTxId: string | null;
         keepSession: boolean;
         refreshBuffer: number;
@@ -54,30 +53,90 @@ declare const EntityServerClient_base: {
         onSessionExpired?: (error: Error) => void;
         _sessionRefreshToken: string | null;
         _refreshTimer: ReturnType<typeof setTimeout> | null;
-        _csrfRefreshTimer: ReturnType<typeof setTimeout> | null;
-        _csrfRefreshPromise: Promise<string> | null;
+        _healthTickTimer: ReturnType<typeof setInterval> | null;
+        _healthTickPromise: Promise<unknown> | null;
         configure(options: Partial<import("./types.js").EntityServerClientOptions>): void;
         setToken(token: string): void;
         setAnonymousPacketToken(token: string): void;
         setApiKey(apiKey: string): void;
         setHmacSecret(secret: string): void;
         setEncryptRequests(value: boolean): void;
-        setCsrfToken(token: string): void;
         setCsrfEnabled(enabled: boolean): void;
+        startHealthTick(intervalMs?: number): void;
+        stopHealthTick(): void;
         _scheduleKeepSession(refreshToken: string, expiresIn: number, refreshFn: (rt: string) => Promise<{
             access_token: string;
             expires_in: number;
         }>): void;
         _clearRefreshTimer(): void;
         stopKeepSession(): void;
-        _clearCsrfRefreshTimer(): void;
-        stopCsrfRefresh(): void;
-        _scheduleCsrfRefresh(expiresIn: number): void;
-        refreshCsrfToken(): Promise<string>;
-        _applyCsrfHealth(csrf?: import("./types.js").EntityServerClientHealthCsrf | null): void;
+        _applyCsrfHealth(): void;
         readRequestBody<T = Record<string, unknown>>(body: ArrayBuffer | Uint8Array | string | T | null | undefined, contentType?: string, requireEncrypted?: boolean): T;
         get _reqOpts(): import("./client/request.js").RequestOptions;
-        requestJson<T>(method: string, path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+        get http(): {
+            get<T>(path: string, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+            post<T>(path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+            put<T>(path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+            patch<T>(path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+            delete<T>(path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+        };
+        requestBinary(method: string, path: string, body?: unknown, withAuth?: boolean): Promise<ArrayBuffer>;
+        requestForm<T>(method: string, path: string, form: FormData, withAuth?: boolean): Promise<T>;
+        requestFormBinary(method: string, path: string, form: FormData, withAuth?: boolean): Promise<ArrayBuffer>;
+        _request<T>(method: string, path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+        _requestBinary(method: string, path: string, body?: unknown, withAuth?: boolean): Promise<ArrayBuffer>;
+        _requestForm<T>(method: string, path: string, form: FormData, withAuth?: boolean): Promise<T>;
+        _requestFormBinary(method: string, path: string, form: FormData, withAuth?: boolean): Promise<ArrayBuffer>;
+    };
+} & {
+    new (...args: any[]): {
+        transactionStart<T = unknown>(body?: Record<string, unknown>): Promise<T>;
+        transactionCommit<T = unknown>(transactionId: string): Promise<T>;
+        transactionRollback<T = unknown>(transactionId: string): Promise<T>;
+        baseUrl: string;
+        token: string;
+        anonymousPacketToken: string;
+        apiKey: string;
+        hmacSecret: string;
+        encryptRequests: boolean;
+        csrfEnabled: boolean;
+        csrfHeaderName: string;
+        csrfCookieName: string;
+        _csrfRefresher: (() => Promise<void>) | null;
+        activeTxId: string | null;
+        keepSession: boolean;
+        refreshBuffer: number;
+        onTokenRefreshed?: (accessToken: string, expiresIn: number) => void;
+        onSessionExpired?: (error: Error) => void;
+        _sessionRefreshToken: string | null;
+        _refreshTimer: ReturnType<typeof setTimeout> | null;
+        _healthTickTimer: ReturnType<typeof setInterval> | null;
+        _healthTickPromise: Promise<unknown> | null;
+        configure(options: Partial<import("./types.js").EntityServerClientOptions>): void;
+        setToken(token: string): void;
+        setAnonymousPacketToken(token: string): void;
+        setApiKey(apiKey: string): void;
+        setHmacSecret(secret: string): void;
+        setEncryptRequests(value: boolean): void;
+        setCsrfEnabled(enabled: boolean): void;
+        startHealthTick(intervalMs?: number): void;
+        stopHealthTick(): void;
+        _scheduleKeepSession(refreshToken: string, expiresIn: number, refreshFn: (rt: string) => Promise<{
+            access_token: string;
+            expires_in: number;
+        }>): void;
+        _clearRefreshTimer(): void;
+        stopKeepSession(): void;
+        _applyCsrfHealth(): void;
+        readRequestBody<T = Record<string, unknown>>(body: ArrayBuffer | Uint8Array | string | T | null | undefined, contentType?: string, requireEncrypted?: boolean): T;
+        get _reqOpts(): import("./client/request.js").RequestOptions;
+        get http(): {
+            get<T>(path: string, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+            post<T>(path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+            put<T>(path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+            patch<T>(path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+            delete<T>(path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+        };
         requestBinary(method: string, path: string, body?: unknown, withAuth?: boolean): Promise<ArrayBuffer>;
         requestForm<T>(method: string, path: string, form: FormData, withAuth?: boolean): Promise<T>;
         requestFormBinary(method: string, path: string, form: FormData, withAuth?: boolean): Promise<ArrayBuffer>;
@@ -127,10 +186,9 @@ declare const EntityServerClient_base: {
         hmacSecret: string;
         encryptRequests: boolean;
         csrfEnabled: boolean;
-        csrfToken: string;
         csrfHeaderName: string;
-        csrfRefreshPath: string;
-        csrfRefreshBuffer: number;
+        csrfCookieName: string;
+        _csrfRefresher: (() => Promise<void>) | null;
         activeTxId: string | null;
         keepSession: boolean;
         refreshBuffer: number;
@@ -138,30 +196,33 @@ declare const EntityServerClient_base: {
         onSessionExpired?: (error: Error) => void;
         _sessionRefreshToken: string | null;
         _refreshTimer: ReturnType<typeof setTimeout> | null;
-        _csrfRefreshTimer: ReturnType<typeof setTimeout> | null;
-        _csrfRefreshPromise: Promise<string> | null;
+        _healthTickTimer: ReturnType<typeof setInterval> | null;
+        _healthTickPromise: Promise<unknown> | null;
         configure(options: Partial<import("./types.js").EntityServerClientOptions>): void;
         setToken(token: string): void;
         setAnonymousPacketToken(token: string): void;
         setApiKey(apiKey: string): void;
         setHmacSecret(secret: string): void;
         setEncryptRequests(value: boolean): void;
-        setCsrfToken(token: string): void;
         setCsrfEnabled(enabled: boolean): void;
+        startHealthTick(intervalMs?: number): void;
+        stopHealthTick(): void;
         _scheduleKeepSession(refreshToken: string, expiresIn: number, refreshFn: (rt: string) => Promise<{
             access_token: string;
             expires_in: number;
         }>): void;
         _clearRefreshTimer(): void;
         stopKeepSession(): void;
-        _clearCsrfRefreshTimer(): void;
-        stopCsrfRefresh(): void;
-        _scheduleCsrfRefresh(expiresIn: number): void;
-        refreshCsrfToken(): Promise<string>;
-        _applyCsrfHealth(csrf?: import("./types.js").EntityServerClientHealthCsrf | null): void;
+        _applyCsrfHealth(): void;
         readRequestBody<T = Record<string, unknown>>(body: ArrayBuffer | Uint8Array | string | T | null | undefined, contentType?: string, requireEncrypted?: boolean): T;
         get _reqOpts(): import("./client/request.js").RequestOptions;
-        requestJson<T>(method: string, path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+        get http(): {
+            get<T>(path: string, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+            post<T>(path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+            put<T>(path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+            patch<T>(path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+            delete<T>(path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+        };
         requestBinary(method: string, path: string, body?: unknown, withAuth?: boolean): Promise<ArrayBuffer>;
         requestForm<T>(method: string, path: string, form: FormData, withAuth?: boolean): Promise<T>;
         requestFormBinary(method: string, path: string, form: FormData, withAuth?: boolean): Promise<ArrayBuffer>;
@@ -180,6 +241,7 @@ declare const EntityServerClient_base: {
             ok: boolean;
             status: string;
         }>;
+        smtpTemplatePreview(templatePath: string): Promise<string>;
         baseUrl: string;
         token: string;
         anonymousPacketToken: string;
@@ -187,10 +249,9 @@ declare const EntityServerClient_base: {
         hmacSecret: string;
         encryptRequests: boolean;
         csrfEnabled: boolean;
-        csrfToken: string;
         csrfHeaderName: string;
-        csrfRefreshPath: string;
-        csrfRefreshBuffer: number;
+        csrfCookieName: string;
+        _csrfRefresher: (() => Promise<void>) | null;
         activeTxId: string | null;
         keepSession: boolean;
         refreshBuffer: number;
@@ -198,30 +259,33 @@ declare const EntityServerClient_base: {
         onSessionExpired?: (error: Error) => void;
         _sessionRefreshToken: string | null;
         _refreshTimer: ReturnType<typeof setTimeout> | null;
-        _csrfRefreshTimer: ReturnType<typeof setTimeout> | null;
-        _csrfRefreshPromise: Promise<string> | null;
+        _healthTickTimer: ReturnType<typeof setInterval> | null;
+        _healthTickPromise: Promise<unknown> | null;
         configure(options: Partial<import("./types.js").EntityServerClientOptions>): void;
         setToken(token: string): void;
         setAnonymousPacketToken(token: string): void;
         setApiKey(apiKey: string): void;
         setHmacSecret(secret: string): void;
         setEncryptRequests(value: boolean): void;
-        setCsrfToken(token: string): void;
         setCsrfEnabled(enabled: boolean): void;
+        startHealthTick(intervalMs?: number): void;
+        stopHealthTick(): void;
         _scheduleKeepSession(refreshToken: string, expiresIn: number, refreshFn: (rt: string) => Promise<{
             access_token: string;
             expires_in: number;
         }>): void;
         _clearRefreshTimer(): void;
         stopKeepSession(): void;
-        _clearCsrfRefreshTimer(): void;
-        stopCsrfRefresh(): void;
-        _scheduleCsrfRefresh(expiresIn: number): void;
-        refreshCsrfToken(): Promise<string>;
-        _applyCsrfHealth(csrf?: import("./types.js").EntityServerClientHealthCsrf | null): void;
+        _applyCsrfHealth(): void;
         readRequestBody<T = Record<string, unknown>>(body: ArrayBuffer | Uint8Array | string | T | null | undefined, contentType?: string, requireEncrypted?: boolean): T;
         get _reqOpts(): import("./client/request.js").RequestOptions;
-        requestJson<T>(method: string, path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+        get http(): {
+            get<T>(path: string, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+            post<T>(path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+            put<T>(path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+            patch<T>(path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+            delete<T>(path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+        };
         requestBinary(method: string, path: string, body?: unknown, withAuth?: boolean): Promise<ArrayBuffer>;
         requestForm<T>(method: string, path: string, form: FormData, withAuth?: boolean): Promise<T>;
         requestFormBinary(method: string, path: string, form: FormData, withAuth?: boolean): Promise<ArrayBuffer>;
@@ -266,10 +330,9 @@ declare const EntityServerClient_base: {
         hmacSecret: string;
         encryptRequests: boolean;
         csrfEnabled: boolean;
-        csrfToken: string;
         csrfHeaderName: string;
-        csrfRefreshPath: string;
-        csrfRefreshBuffer: number;
+        csrfCookieName: string;
+        _csrfRefresher: (() => Promise<void>) | null;
         activeTxId: string | null;
         keepSession: boolean;
         refreshBuffer: number;
@@ -277,30 +340,33 @@ declare const EntityServerClient_base: {
         onSessionExpired?: (error: Error) => void;
         _sessionRefreshToken: string | null;
         _refreshTimer: ReturnType<typeof setTimeout> | null;
-        _csrfRefreshTimer: ReturnType<typeof setTimeout> | null;
-        _csrfRefreshPromise: Promise<string> | null;
+        _healthTickTimer: ReturnType<typeof setInterval> | null;
+        _healthTickPromise: Promise<unknown> | null;
         configure(options: Partial<import("./types.js").EntityServerClientOptions>): void;
         setToken(token: string): void;
         setAnonymousPacketToken(token: string): void;
         setApiKey(apiKey: string): void;
         setHmacSecret(secret: string): void;
         setEncryptRequests(value: boolean): void;
-        setCsrfToken(token: string): void;
         setCsrfEnabled(enabled: boolean): void;
+        startHealthTick(intervalMs?: number): void;
+        stopHealthTick(): void;
         _scheduleKeepSession(refreshToken: string, expiresIn: number, refreshFn: (rt: string) => Promise<{
             access_token: string;
             expires_in: number;
         }>): void;
         _clearRefreshTimer(): void;
         stopKeepSession(): void;
-        _clearCsrfRefreshTimer(): void;
-        stopCsrfRefresh(): void;
-        _scheduleCsrfRefresh(expiresIn: number): void;
-        refreshCsrfToken(): Promise<string>;
-        _applyCsrfHealth(csrf?: import("./types.js").EntityServerClientHealthCsrf | null): void;
+        _applyCsrfHealth(): void;
         readRequestBody<T = Record<string, unknown>>(body: ArrayBuffer | Uint8Array | string | T | null | undefined, contentType?: string, requireEncrypted?: boolean): T;
         get _reqOpts(): import("./client/request.js").RequestOptions;
-        requestJson<T>(method: string, path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+        get http(): {
+            get<T>(path: string, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+            post<T>(path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+            put<T>(path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+            patch<T>(path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+            delete<T>(path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+        };
         requestBinary(method: string, path: string, body?: unknown, withAuth?: boolean): Promise<ArrayBuffer>;
         requestForm<T>(method: string, path: string, form: FormData, withAuth?: boolean): Promise<T>;
         requestFormBinary(method: string, path: string, form: FormData, withAuth?: boolean): Promise<ArrayBuffer>;
@@ -380,10 +446,9 @@ declare const EntityServerClient_base: {
         hmacSecret: string;
         encryptRequests: boolean;
         csrfEnabled: boolean;
-        csrfToken: string;
         csrfHeaderName: string;
-        csrfRefreshPath: string;
-        csrfRefreshBuffer: number;
+        csrfCookieName: string;
+        _csrfRefresher: (() => Promise<void>) | null;
         activeTxId: string | null;
         keepSession: boolean;
         refreshBuffer: number;
@@ -391,30 +456,33 @@ declare const EntityServerClient_base: {
         onSessionExpired?: (error: Error) => void;
         _sessionRefreshToken: string | null;
         _refreshTimer: ReturnType<typeof setTimeout> | null;
-        _csrfRefreshTimer: ReturnType<typeof setTimeout> | null;
-        _csrfRefreshPromise: Promise<string> | null;
+        _healthTickTimer: ReturnType<typeof setInterval> | null;
+        _healthTickPromise: Promise<unknown> | null;
         configure(options: Partial<import("./types.js").EntityServerClientOptions>): void;
         setToken(token: string): void;
         setAnonymousPacketToken(token: string): void;
         setApiKey(apiKey: string): void;
         setHmacSecret(secret: string): void;
         setEncryptRequests(value: boolean): void;
-        setCsrfToken(token: string): void;
         setCsrfEnabled(enabled: boolean): void;
+        startHealthTick(intervalMs?: number): void;
+        stopHealthTick(): void;
         _scheduleKeepSession(refreshToken: string, expiresIn: number, refreshFn: (rt: string) => Promise<{
             access_token: string;
             expires_in: number;
         }>): void;
         _clearRefreshTimer(): void;
         stopKeepSession(): void;
-        _clearCsrfRefreshTimer(): void;
-        stopCsrfRefresh(): void;
-        _scheduleCsrfRefresh(expiresIn: number): void;
-        refreshCsrfToken(): Promise<string>;
-        _applyCsrfHealth(csrf?: import("./types.js").EntityServerClientHealthCsrf | null): void;
+        _applyCsrfHealth(): void;
         readRequestBody<T = Record<string, unknown>>(body: ArrayBuffer | Uint8Array | string | T | null | undefined, contentType?: string, requireEncrypted?: boolean): T;
         get _reqOpts(): import("./client/request.js").RequestOptions;
-        requestJson<T>(method: string, path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+        get http(): {
+            get<T>(path: string, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+            post<T>(path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+            put<T>(path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+            patch<T>(path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+            delete<T>(path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+        };
         requestBinary(method: string, path: string, body?: unknown, withAuth?: boolean): Promise<ArrayBuffer>;
         requestForm<T>(method: string, path: string, form: FormData, withAuth?: boolean): Promise<T>;
         requestFormBinary(method: string, path: string, form: FormData, withAuth?: boolean): Promise<ArrayBuffer>;
@@ -498,10 +566,9 @@ declare const EntityServerClient_base: {
         hmacSecret: string;
         encryptRequests: boolean;
         csrfEnabled: boolean;
-        csrfToken: string;
         csrfHeaderName: string;
-        csrfRefreshPath: string;
-        csrfRefreshBuffer: number;
+        csrfCookieName: string;
+        _csrfRefresher: (() => Promise<void>) | null;
         activeTxId: string | null;
         keepSession: boolean;
         refreshBuffer: number;
@@ -509,30 +576,33 @@ declare const EntityServerClient_base: {
         onSessionExpired?: (error: Error) => void;
         _sessionRefreshToken: string | null;
         _refreshTimer: ReturnType<typeof setTimeout> | null;
-        _csrfRefreshTimer: ReturnType<typeof setTimeout> | null;
-        _csrfRefreshPromise: Promise<string> | null;
+        _healthTickTimer: ReturnType<typeof setInterval> | null;
+        _healthTickPromise: Promise<unknown> | null;
         configure(options: Partial<import("./types.js").EntityServerClientOptions>): void;
         setToken(token: string): void;
         setAnonymousPacketToken(token: string): void;
         setApiKey(apiKey: string): void;
         setHmacSecret(secret: string): void;
         setEncryptRequests(value: boolean): void;
-        setCsrfToken(token: string): void;
         setCsrfEnabled(enabled: boolean): void;
+        startHealthTick(intervalMs?: number): void;
+        stopHealthTick(): void;
         _scheduleKeepSession(refreshToken: string, expiresIn: number, refreshFn: (rt: string) => Promise<{
             access_token: string;
             expires_in: number;
         }>): void;
         _clearRefreshTimer(): void;
         stopKeepSession(): void;
-        _clearCsrfRefreshTimer(): void;
-        stopCsrfRefresh(): void;
-        _scheduleCsrfRefresh(expiresIn: number): void;
-        refreshCsrfToken(): Promise<string>;
-        _applyCsrfHealth(csrf?: import("./types.js").EntityServerClientHealthCsrf | null): void;
+        _applyCsrfHealth(): void;
         readRequestBody<T = Record<string, unknown>>(body: ArrayBuffer | Uint8Array | string | T | null | undefined, contentType?: string, requireEncrypted?: boolean): T;
         get _reqOpts(): import("./client/request.js").RequestOptions;
-        requestJson<T>(method: string, path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+        get http(): {
+            get<T>(path: string, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+            post<T>(path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+            put<T>(path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+            patch<T>(path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+            delete<T>(path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+        };
         requestBinary(method: string, path: string, body?: unknown, withAuth?: boolean): Promise<ArrayBuffer>;
         requestForm<T>(method: string, path: string, form: FormData, withAuth?: boolean): Promise<T>;
         requestFormBinary(method: string, path: string, form: FormData, withAuth?: boolean): Promise<ArrayBuffer>;
@@ -543,12 +613,10 @@ declare const EntityServerClient_base: {
     };
 } & {
     new (...args: any[]): {
+        _csrfRefresher: () => Promise<void>;
         checkHealth(): Promise<{
-            ok: boolean;
-            packet_encryption?: boolean;
-            packet_mode?: string;
+            status: string;
             packet_token?: string;
-            csrf?: import("./types.js").EntityServerClientHealthCsrf;
         }>;
         login(email: string, password: string): Promise<{
             access_token: string;
@@ -572,16 +640,6 @@ declare const EntityServerClient_base: {
         withdraw(passwd?: string): Promise<{
             ok: boolean;
         }>;
-        reactivate(params: {
-            email: string;
-            passwd?: string;
-            provider?: string;
-            code?: string;
-        }): Promise<{
-            access_token: string;
-            refresh_token: string;
-            expires_in: number;
-        }>;
         baseUrl: string;
         token: string;
         anonymousPacketToken: string;
@@ -589,10 +647,8 @@ declare const EntityServerClient_base: {
         hmacSecret: string;
         encryptRequests: boolean;
         csrfEnabled: boolean;
-        csrfToken: string;
         csrfHeaderName: string;
-        csrfRefreshPath: string;
-        csrfRefreshBuffer: number;
+        csrfCookieName: string;
         activeTxId: string | null;
         keepSession: boolean;
         refreshBuffer: number;
@@ -600,30 +656,33 @@ declare const EntityServerClient_base: {
         onSessionExpired?: (error: Error) => void;
         _sessionRefreshToken: string | null;
         _refreshTimer: ReturnType<typeof setTimeout> | null;
-        _csrfRefreshTimer: ReturnType<typeof setTimeout> | null;
-        _csrfRefreshPromise: Promise<string> | null;
+        _healthTickTimer: ReturnType<typeof setInterval> | null;
+        _healthTickPromise: Promise<unknown> | null;
         configure(options: Partial<import("./types.js").EntityServerClientOptions>): void;
         setToken(token: string): void;
         setAnonymousPacketToken(token: string): void;
         setApiKey(apiKey: string): void;
         setHmacSecret(secret: string): void;
         setEncryptRequests(value: boolean): void;
-        setCsrfToken(token: string): void;
         setCsrfEnabled(enabled: boolean): void;
+        startHealthTick(intervalMs?: number): void;
+        stopHealthTick(): void;
         _scheduleKeepSession(refreshToken: string, expiresIn: number, refreshFn: (rt: string) => Promise<{
             access_token: string;
             expires_in: number;
         }>): void;
         _clearRefreshTimer(): void;
         stopKeepSession(): void;
-        _clearCsrfRefreshTimer(): void;
-        stopCsrfRefresh(): void;
-        _scheduleCsrfRefresh(expiresIn: number): void;
-        refreshCsrfToken(): Promise<string>;
-        _applyCsrfHealth(csrf?: import("./types.js").EntityServerClientHealthCsrf | null): void;
+        _applyCsrfHealth(): void;
         readRequestBody<T = Record<string, unknown>>(body: ArrayBuffer | Uint8Array | string | T | null | undefined, contentType?: string, requireEncrypted?: boolean): T;
         get _reqOpts(): import("./client/request.js").RequestOptions;
-        requestJson<T>(method: string, path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+        get http(): {
+            get<T>(path: string, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+            post<T>(path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+            put<T>(path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+            patch<T>(path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+            delete<T>(path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+        };
         requestBinary(method: string, path: string, body?: unknown, withAuth?: boolean): Promise<ArrayBuffer>;
         requestForm<T>(method: string, path: string, form: FormData, withAuth?: boolean): Promise<T>;
         requestFormBinary(method: string, path: string, form: FormData, withAuth?: boolean): Promise<ArrayBuffer>;
@@ -633,6 +692,6 @@ declare const EntityServerClient_base: {
         _requestFormBinary(method: string, path: string, form: FormData, withAuth?: boolean): Promise<ArrayBuffer>;
     };
 } & typeof EntityServerClientBase;
-export declare class EntityServerClient extends EntityServerClient_base {
+export declare class EntityServerApi extends EntityServerApi_base {
 }
 export {};

package/dist/EntityServerApi.js

@@ -0,0 +1,2 @@
+import{EntityServerClientBase as i}from"./client/base.js";import{AdminMixin as n,AuthMixin as t,EntityMixin as e,FileMixin as r,PushMixin as x,SmtpMixin as M,TransactionMixin as s,UtilsMixin as m}from"./mixins/server/index.js";class l extends m(s(r(M(x(n(e(t(i)))))))){}export{l as EntityServerApi};
+//# sourceMappingURL=EntityServerApi.js.map

package/dist/EntityServerApi.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/EntityServerApi.ts"],
+  "sourcesContent": ["/**\n * @file EntityServerApi.ts\n * entity-server core route\uC6A9 Mixin \uC870\uD569 \uD074\uB77C\uC774\uC5B8\uD2B8.\n *\n * \uC808(section)\uBCC4 \uAD6C\uD604:\n *   src/client/base.ts            \u2014 \uC0C1\uD0DC\u00B7\uC0DD\uC131\uC790\u00B7\uACF5\uD1B5 \uD5EC\uD37C\n *   src/mixins/server/*           \u2014 entity-server core route mixin\n *   src/mixins/app/*              \u2014 entity-app-server plugin mixin\n */\nimport { EntityServerClientBase } from \"./client/base.js\";\nimport {\n    AdminMixin,\n    AuthMixin,\n    EntityMixin,\n    FileMixin,\n    PushMixin,\n    SmtpMixin,\n    TransactionMixin,\n    UtilsMixin,\n} from \"./mixins/server/index.js\";\n\n// \u2500\u2500\u2500 Composed class \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport class EntityServerApi extends UtilsMixin(\n    TransactionMixin(\n        FileMixin(\n            SmtpMixin(\n                PushMixin(\n                    AdminMixin(EntityMixin(AuthMixin(EntityServerClientBase))),\n                ),\n            ),\n        ),\n    ),\n) {}\n"],
+  "mappings": "AASA,OAAS,0BAAAA,MAA8B,mBACvC,OACI,cAAAC,EACA,aAAAC,EACA,eAAAC,EACA,aAAAC,EACA,aAAAC,EACA,aAAAC,EACA,oBAAAC,EACA,cAAAC,MACG,2BAIA,MAAMC,UAAwBD,EACjCD,EACIH,EACIE,EACID,EACIJ,EAAWE,EAAYD,EAAUF,CAAsB,CAAC,CAAC,CAC7D,CACJ,CACJ,CACJ,CACJ,CAAE,CAAC",
+  "names": ["EntityServerClientBase", "AdminMixin", "AuthMixin", "EntityMixin", "FileMixin", "PushMixin", "SmtpMixin", "TransactionMixin", "UtilsMixin", "EntityServerApi"]
+}

package/dist/client/base.d.ts

@@ -1,4 +1,4 @@
-import type { EntityServerClientHealthCsrf, EntityServerClientOptions } from "../types.js";
+import type { EntityServerClientOptions } from "../types.js";
 import { type RequestOptions } from "./request.js";
 export type GConstructor<T = object> = new (...args: any[]) => T;
 export declare class EntityServerClientBase {
@@ -9,10 +9,10 @@ export declare class EntityServerClientBase {
     hmacSecret: string;
     encryptRequests: boolean;
     csrfEnabled: boolean;
-    csrfToken: string;
     csrfHeaderName: string;
-    csrfRefreshPath: string;
-    csrfRefreshBuffer: number;
+    csrfCookieName: string;
+    /** @internal health 재호출로 CSRF 쿠키 갱신 (AuthMixin에서 설정) */
+    _csrfRefresher: (() => Promise<void>) | null;
     activeTxId: string | null;
     keepSession: boolean;
     refreshBuffer: number;
@@ -20,8 +20,8 @@ export declare class EntityServerClientBase {
     onSessionExpired?: (error: Error) => void;
     _sessionRefreshToken: string | null;
     _refreshTimer: ReturnType<typeof setTimeout> | null;
-    _csrfRefreshTimer: ReturnType<typeof setTimeout> | null;
-    _csrfRefreshPromise: Promise<string> | null;
+    _healthTickTimer: ReturnType<typeof setInterval> | null;
+    _healthTickPromise: Promise<unknown> | null;
     /**
      * EntityServerClient 인스턴스를 생성합니다.
      *
@@ -41,8 +41,16 @@ export declare class EntityServerClientBase {
     setHmacSecret(secret: string): void;
     /** 암호화 요청 활성화 여부를 설정합니다. */
     setEncryptRequests(value: boolean): void;
-    setCsrfToken(token: string): void;
     setCsrfEnabled(enabled: boolean): void;
+    /**
+     * 주기적으로 health 체크를 실행합니다.
+     * CSRF 쿠키 갱신과 서버 상태 확인을 자동화합니다.
+     *
+     * @param intervalMs 호출 주기(ms). 기본값: 5분
+     */
+    startHealthTick(intervalMs?: number): void;
+    /** health tick 타이머를 중지합니다. */
+    stopHealthTick(): void;
     /** @internal 자동 토큰 갱신 타이머를 시작합니다. */
     _scheduleKeepSession(refreshToken: string, expiresIn: number, refreshFn: (rt: string) => Promise<{
         access_token: string;
@@ -55,11 +63,7 @@ export declare class EntityServerClientBase {
      * `logout()` 호출 시 자동으로 중지되며, 직접 호출이 필요한 경우는 드뭅니다.
      */
     stopKeepSession(): void;
-    _clearCsrfRefreshTimer(): void;
-    stopCsrfRefresh(): void;
-    _scheduleCsrfRefresh(expiresIn: number): void;
-    refreshCsrfToken(): Promise<string>;
-    _applyCsrfHealth(csrf?: EntityServerClientHealthCsrf | null): void;
+    _applyCsrfHealth(): void;
     /**
      * 요청 바디를 파싱합니다.
      * `application/octet-stream`이면 XChaCha20-Poly1305 복호화, 그 외는 JSON 파싱합니다.
@@ -69,11 +73,20 @@ export declare class EntityServerClientBase {
     readRequestBody<T = Record<string, unknown>>(body: ArrayBuffer | Uint8Array | string | T | null | undefined, contentType?: string, requireEncrypted?: boolean): T;
     get _reqOpts(): RequestOptions;
     /**
-     * 임의 경로에 JSON 요청을 보냅니다. 응답이 JSON이면 파싱, octet-stream이면 자동 복호화합니다.
-     * `ok` 필드를 강제하지 않아 go서버/앱서버 신규 라우트 등 자유 응답 포맷에 사용합니다.
-     * `encryptRequests: true`이면 요청 바디도 자동 암호화됩니다.
+     * 커스텀 라우트 직접 호출용 HTTP 네임스페이스.
+     * 인증·암호화·HMAC 등 SDK 옵션이 그대로 적용됩니다.
+     *
+     * @example
+     * const res = await client.http.get<{ version: string }>("/api/v1/status", false);
+     * const res = await client.http.post<MyResponse>("/api/v1/custom", { key: "value" });
      */
-    requestJson<T>(method: string, path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+    get http(): {
+        get<T>(path: string, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+        post<T>(path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+        put<T>(path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+        patch<T>(path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+        delete<T>(path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+    };
     /**
      * 임의 경로에 요청을 보내고 바이너리(ArrayBuffer)를 반환합니다.
      * 이미지, PDF, 압축 파일 등 바이너리 응답이 오는 엔드포인트에 사용합니다.