@sayren/store-sdk 0.22.0 → 0.28.0

package/dist/server.d.mts

@@ -1,47 +1,38 @@
 import { a as WEBHOOK_HEADERS, i as WEBHOOK_EVENT_TYPE_HEADER, n as WEBHOOK_DELIVERY_ID_HEADER, o as WEBHOOK_SIGNATURE_HEADER, r as WEBHOOK_EVENT_ID_HEADER, s as WEBHOOK_USER_AGENT, t as WEBHOOK_DEFAULT_TOLERANCE_SEC } from "./webhook-headers-D6QmPdEJ.mjs";
 //#region src/member-delegation.d.ts
 /**
- * 구매자 위임 — 자체 회원 시스템을 가진 셀러 서버가 로그인한 사용자를 sayren 구매자 토큰으로 바꾼다
- * (token-exchange의 `member-uid`·`member-ref` 확장, auth-spec §12-10). 클라이언트 시크릿을 쓰므로 **서버에서만** 부른다.
+ * 구매자 위임 — 자체 회원 시스템을 가진 셀러 서버가 로그인한 사용자를 sayren 구매자 토큰으로 바꾼다.
+ * 계정 토큰(개인 액세스 토큰 등)을 쓰므로 **서버에서만** 부른다.
  *
- * 스토어에 바인딩된 confidential 클라이언트 + `member:delegate` 스코프가 필요하다. 응답은 구매자 액세스 토큰(30분)이고
- * refresh는 없다 — 만료되면 같은 호출로 다시 받는다.
+ * 응답은 구매자 액세스 토큰(30분)이고 refresh는 없다 — 만료되면 같은 호출로 다시 받는다.
  */
 interface DelegatedMemberToken {
   accessToken: string;
   expiresIn: number;
   memberId: string;
 }
-interface DelegationOptions {
-  /** api 주소(예: `https://api.sayren.app`) — `/v1/oauth2/token`을 붙인다 */
-  baseUrl: string;
-  clientId: string;
-  clientSecret: string;
-  fetch?: typeof globalThis.fetch;
-}
-/** 셀러 자체 인증의 사용자 id로 지목한다. 처음 보는 id면 구매자를 만든다(이메일·이름은 그때만 쓴다) */
-export declare function delegateMemberByUid(options: DelegationOptions & {
-  uid: string;
-  email?: string;
-  name?: string;
-  /**
-   * 사용자가 내 서비스에서 실제로 로그인한 시각. 주면 구매자 토큰의 인증 시각이 되고(탈퇴처럼 최근 인증이 필요한 동작에
-   * 쓴다), 주지 않으면 인증 시각이 없는 토큰이 나온다
-   */
-  authenticatedAt?: Date;
-}): Promise<DelegatedMemberToken>;
-/** 이메일로 지목한다. 처음 보는 이메일이면 구매자를 만든다 */
-export declare function delegateMemberByEmail(options: DelegationOptions & {
-  email: string;
-  name?: string;
-}): Promise<DelegatedMemberToken>;
-/** 위임 실패 — `error`는 OAuth 오류 코드(`invalid_client`·`invalid_scope`·`invalid_request` 등) */
+/** 위임 실패 — `error`는 api 오류 코드(엔벨로프 `error.code`, 없으면 `http_{status}`) */
 export declare class MemberDelegationError extends Error {
   readonly error: string;
   readonly description: string;
   readonly status: number;
   constructor(error: string, description: string, status: number);
 }
+/**
+ * 계정 토큰으로 구매자 위임(`POST /v1/customers/delegations`) — 계정 토큰(개인 액세스 토큰 등)과 스토어 id를 쓴다.
+ * `customer:rw`가 필요하다. `uid`(셀러 자체 인증의 사용자 id) 또는 `email`로 지목하고, 처음 보는 사용자면 구매자를 만든다.
+ */
+export declare function delegateMember(options: {
+  /** api 주소(예: `https://api.sayren.app`) */
+  baseUrl: string;
+  accessToken: string;
+  storeId: string;
+  uid?: string;
+  email?: string;
+  name?: string;
+  authenticatedAt?: Date;
+  fetch?: typeof globalThis.fetch;
+}): Promise<DelegatedMemberToken>;
 //#endregion
 //#region src/webhook-signature.d.ts
 interface SignWebhookPayloadOptions {

package/dist/server.mjs

@@ -1,46 +1,6 @@
 import { a as WEBHOOK_HEADERS, i as WEBHOOK_EVENT_TYPE_HEADER, n as WEBHOOK_DELIVERY_ID_HEADER, o as WEBHOOK_SIGNATURE_HEADER, r as WEBHOOK_EVENT_ID_HEADER, s as WEBHOOK_USER_AGENT, t as WEBHOOK_DEFAULT_TOLERANCE_SEC } from "./webhook-headers-ap_exsb9.mjs";
 //#region src/member-delegation.ts
-/** 셀러 자체 인증의 사용자 id로 지목한다. 처음 보는 id면 구매자를 만든다(이메일·이름은 그때만 쓴다) */
-function delegateMemberByUid(options) {
-	return delegate(options, {
-		subject_token_type: "urn:sayren:params:oauth:token-type:member-uid",
-		subject_token: options.uid,
-		...options.authenticatedAt ? { subject_auth_time: String(Math.floor(options.authenticatedAt.getTime() / 1e3)) } : {},
-		...options.email ? { subject_email: options.email } : {},
-		...options.name ? { subject_name: options.name } : {}
-	});
-}
-/** 이메일로 지목한다. 처음 보는 이메일이면 구매자를 만든다 */
-function delegateMemberByEmail(options) {
-	return delegate(options, {
-		subject_token_type: "urn:sayren:params:oauth:token-type:member-ref",
-		subject_token: options.email,
-		...options.name ? { subject_name: options.name } : {}
-	});
-}
-async function delegate(options, subject) {
-	const doFetch = options.fetch ?? globalThis.fetch;
-	const basic = btoa(`${options.clientId}:${options.clientSecret}`);
-	const res = await doFetch(`${options.baseUrl.replace(/\/+$/, "")}/v1/oauth2/token`, {
-		method: "POST",
-		headers: {
-			"content-type": "application/x-www-form-urlencoded",
-			authorization: `Basic ${basic}`
-		},
-		body: new URLSearchParams({
-			grant_type: "urn:ietf:params:oauth:grant-type:token-exchange",
-			...subject
-		}).toString()
-	});
-	const body = await res.json().catch(() => ({}));
-	if (!res.ok || typeof body.access_token !== "string") throw new MemberDelegationError(typeof body.error === "string" ? body.error : `http_${res.status}`, typeof body.error_description === "string" ? body.error_description : "", res.status);
-	return {
-		accessToken: body.access_token,
-		expiresIn: Number(body.expires_in),
-		memberId: String(body.memberId)
-	};
-}
-/** 위임 실패 — `error`는 OAuth 오류 코드(`invalid_client`·`invalid_scope`·`invalid_request` 등) */
+/** 위임 실패 — `error`는 api 오류 코드(엔벨로프 `error.code`, 없으면 `http_{status}`) */
 var MemberDelegationError = class extends Error {
 	error;
 	description;
@@ -53,6 +13,33 @@ var MemberDelegationError = class extends Error {
 		this.name = "MemberDelegationError";
 	}
 };
+/**
+* 계정 토큰으로 구매자 위임(`POST /v1/customers/delegations`) — 계정 토큰(개인 액세스 토큰 등)과 스토어 id를 쓴다.
+* `customer:rw`가 필요하다. `uid`(셀러 자체 인증의 사용자 id) 또는 `email`로 지목하고, 처음 보는 사용자면 구매자를 만든다.
+*/
+async function delegateMember(options) {
+	const res = await (options.fetch ?? globalThis.fetch)(`${options.baseUrl.replace(/\/+$/, "")}/v1/customers/delegations`, {
+		method: "POST",
+		headers: {
+			"content-type": "application/json",
+			authorization: `Bearer ${options.accessToken}`,
+			"x-store-id": options.storeId
+		},
+		body: JSON.stringify({
+			...options.uid ? { uid: options.uid } : {},
+			...options.email ? { email: options.email } : {},
+			...options.name ? { name: options.name } : {},
+			...options.authenticatedAt ? { authenticatedAt: options.authenticatedAt.toISOString() } : {}
+		})
+	});
+	const body = await res.json().catch(() => ({}));
+	if (!res.ok || typeof body.data?.accessToken !== "string") throw new MemberDelegationError(typeof body.error?.code === "string" ? body.error.code : `http_${res.status}`, typeof body.error?.message === "string" ? body.error.message : "", res.status);
+	return {
+		accessToken: body.data.accessToken,
+		expiresIn: Number(body.data.expiresIn),
+		memberId: String(body.data.memberId)
+	};
+}
 //#endregion
 //#region src/webhook-signature.ts
 /**
@@ -177,4 +164,4 @@ async function verifyWebhookSignature(options) {
 	};
 }
 //#endregion
-export { MemberDelegationError, WEBHOOK_DEFAULT_TOLERANCE_SEC, WEBHOOK_DELIVERY_ID_HEADER, WEBHOOK_EVENT_ID_HEADER, WEBHOOK_EVENT_TYPE_HEADER, WEBHOOK_HEADERS, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_USER_AGENT, delegateMemberByEmail, delegateMemberByUid, parseWebhookSignatureHeader, signWebhookPayload, verifyWebhookSignature };
+export { MemberDelegationError, WEBHOOK_DEFAULT_TOLERANCE_SEC, WEBHOOK_DELIVERY_ID_HEADER, WEBHOOK_EVENT_ID_HEADER, WEBHOOK_EVENT_TYPE_HEADER, WEBHOOK_HEADERS, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_USER_AGENT, delegateMember, parseWebhookSignatureHeader, signWebhookPayload, verifyWebhookSignature };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sayren/store-sdk",
-  "version": "0.22.0",
+  "version": "0.28.0",
   "main": "./dist/index.mjs",
   "types": "./dist/index.d.mts",
   "exports": {

package/src/client.ts

@@ -1,14 +1,5 @@
 import { z } from "zod";
-import { base64Utf8 } from "./base64";
-import {
-  ApiError,
-  createHttp,
-  path,
-  type Query,
-  resolveToken,
-  type TokenSource,
-  unwrapData,
-} from "./http";
+import { ApiError, createHttp, path, type Query, resolveToken, type TokenSource } from "./http";
 import {
   type AnalyticsPagesParams,
   type AnalyticsProductsParams,
@@ -29,14 +20,6 @@ import {
   analyticsSourcesQuerySchema,
   analyticsSourcesSchema,
 } from "./schemas/analytics";
-import {
-  type ApiClientListParams,
-  apiClientSchema,
-  apiClientSecretRotatedSchema,
-  type OAuthClientRegistrationRequest,
-  oauthClientRegistrationRequestSchema,
-  oauthClientRegistrationResponseSchema,
-} from "./schemas/api-client";
 import { type ApiLogListOptions, apiLogPageSchema, apiLogSummarySchema } from "./schemas/api-log";
 import {
   type ApprovalDecisionRequest,
@@ -47,15 +30,7 @@ import {
   approvalRequestSchema,
   auditLogPageSchema,
 } from "./schemas/audit";
-import {
-  type ApiTokenCreateRequest,
-  apiTokenCreatedSchema,
-  apiTokenCreateRequestSchema,
-  apiTokenSchema,
-  clientCredentialsTokenResponseSchema,
-  myAccountSchema,
-  myStoreSchema,
-} from "./schemas/auth";
+import { myAccountSchema, myStoreSchema } from "./schemas/auth";
 import {
   type CategoryCreateRequest,
   type CategoryDeleteStrategy,
@@ -264,6 +239,7 @@ import {
   setStorefrontVisibilityRequestSchema,
   storefrontBuildSchema,
   storefrontCheckSchema,
+  storefrontDeploymentSchema,
   storefrontEditingSchema,
   storefrontFileContentSchema,
   storefrontFileDeleteResultSchema,
@@ -291,6 +267,7 @@ import {
   type WriteStorefrontFilesRequest,
   writeStorefrontFilesRequestSchema,
 } from "./schemas/storefront-hosting";
+import { publicPlansSchema, storeSubscriptionSchema } from "./schemas/subscription";
 import {
   type UploadPurpose,
   type UploadRequest,
@@ -304,20 +281,16 @@ import type { AuthorizeOptions, StoreSession } from "./session";
 export interface StoreClientOptions {
   /** 예: https://api.example.com/v1 */
   baseUrl: string;
-  /** 유저 토큰 (1단계). 인증/스토어 목록 API에 사용 */
-  userToken?: TokenSource;
-  /** 스토어 토큰 (3단계). 테넌트 리소스 API에 사용 */
-  storeToken?: TokenSource;
-  /** 테넌트 storeId — storeHttp(테넌트 리소스) 요청에 X-Store-Id로 실린다(userToken 직접 인가). */
-  storeId?: TokenSource;
   /**
-   * 토큰 주입 모드 — PAT/storeToken급(테넌트 바인딩, role 없음)을 storeHttp Bearer로 싣는다.
-   * userToken이 아니다(비인터랙티브 M2M/CLI 경로용). storeToken과 함께 주면 storeToken이 우선한다.
+   * 계정 토큰(accounts가 발급한 JWT — 콘솔 로그인, 개인 액세스 토큰, 연결된 앱의 토큰).
+   * 계정 API(`/me/*`)와 스토어 API 모두에 Bearer로 싣는다. `session`을 주면 생략해도 세션 토큰을 쓴다.
    */
-  auth?: { apiToken?: string };
+  accessToken?: TokenSource;
+  /** 대상 스토어 id — 스토어 API 요청에 `X-Store-Id`로 싣는다. 계정 API(`/me/*`)에는 싣지 않는다 */
+  storeId?: TokenSource;
   /**
-   * SDK 세션 매니저 — 전달하면 userToken(Bearer)·401 refresh·복구불가 시 clear를
-   * 이 세션에서 자동 배선한다. 개별 옵션(userToken/refresh/onUnauthorized)을 명시하면 그쪽이 우선한다.
+   * SDK 세션 매니저 — 전달하면 Bearer 토큰·401 refresh·복구 불가 시 clear를
+   * 이 세션에서 자동 배선한다. 개별 옵션(accessToken/refresh/onUnauthorized)을 명시하면 그쪽이 우선한다.
    */
   session?: StoreSession;
   /** 401 시 세션 갱신 시도 — true면 요청을 1회 재시도한다(refresh 토큰 회전) */
@@ -327,44 +300,37 @@ export interface StoreClientOptions {
   fetch?: typeof globalThis.fetch;
 }
 
-function formBody(fields: Record<string, string>): string {
-  return new URLSearchParams(fields).toString();
-}
-
 export function createStoreClient(options: StoreClientOptions) {
   const fetchFn = options.fetch ?? globalThis.fetch;
   const { session } = options;
 
-  // session이 있으면 userToken/refresh/onUnauthorized의 기본값을 세션에서 배선한다.
-  // 개별 옵션을 명시하면 그쪽이 우선(하위호환) — session 미전달 시 기존 동작 그대로.
-  const userTokenSource: TokenSource =
-    options.userToken ?? (session ? () => session.getToken() : undefined);
+  // session이 있으면 토큰/refresh/onUnauthorized의 기본값을 세션에서 배선한다. 개별 옵션을 명시하면 그쪽이 우선한다.
+  const tokenSource: TokenSource =
+    options.accessToken ?? (session ? () => session.getToken() : undefined);
   const refresh = options.refresh ?? (session ? () => session.refresh() : undefined);
   const onUnauthorized = options.onUnauthorized ?? (session ? () => session.clear() : undefined);
-  // storeToken(명시 옵션)이 auth.apiToken(PAT/storeToken급 주입)보다 우선한다.
-  const storeTokenSource: TokenSource = options.storeToken ?? options.auth?.apiToken;
 
+  function bearer(): Record<string, string> {
+    const token = resolveToken(tokenSource);
+    return token ? { authorization: `Bearer ${token}` } : {};
+  }
+
+  /** 계정 API(`/me/*`) — 스토어를 고르지 않는다 */
   const userHttp = createHttp({
     baseUrl: options.baseUrl,
     fetch: fetchFn,
-    headers: () => {
-      const token = resolveToken(userTokenSource);
-      return token ? { authorization: `Bearer ${token}` } : ({} as Record<string, string>);
-    },
+    headers: bearer,
     refresh,
     onUnauthorized,
   });
 
+  /** 스토어 API — 같은 계정 토큰 + `X-Store-Id` */
   const storeHttp = createHttp({
     baseUrl: options.baseUrl,
     fetch: fetchFn,
     headers: () => {
-      const token = resolveToken(storeTokenSource);
       const storeId = resolveToken(options.storeId);
-      return {
-        ...(token ? { authorization: `Bearer ${token}` } : {}),
-        ...(storeId ? { "x-store-id": storeId } : {}),
-      };
+      return { ...bearer(), ...(storeId ? { "x-store-id": storeId } : {}) };
     },
     refresh,
     onUnauthorized,
@@ -390,7 +356,7 @@ export function createStoreClient(options: StoreClientOptions) {
   }
 
   return {
-    /** session의 현재 userToken (session 미배선 시 null — 던지지 않음) */
+    /** session의 현재 액세스 토큰 (session 미배선 시 null — 던지지 않음) */
     get accessToken(): string | null {
       return session ? session.accessToken : null;
     },
@@ -404,90 +370,11 @@ export function createStoreClient(options: StoreClientOptions) {
     userinfo: () => requireSession().userinfo(),
 
     auth: {
-      /**
-       * 서버 간 연동(M2M) — client_credentials grant (client_secret_basic).
-       * 클라이언트가 스토어에 바인딩되어 있어 **storeToken이 곧바로 발급**된다.
-       * ⚠ client_secret은 서버 환경에서만 사용할 것 (브라우저 반입 금지)
-       */
-      async issueStoreTokenByClientCredentials(
-        clientId: string,
-        clientSecret: string,
-        scope?: string,
-      ) {
-        // RFC 7617 client_secret_basic — UTF-8 바이트를 base64로 인코딩한다.
-        const credentials = base64Utf8(`${clientId}:${clientSecret}`);
-        const response = await fetchFn(`${options.baseUrl}/oauth2/token`, {
-          method: "POST",
-          headers: {
-            "content-type": "application/x-www-form-urlencoded",
-            authorization: `Basic ${credentials}`,
-          },
-          body: formBody({ grant_type: "client_credentials", ...(scope ? { scope } : {}) }),
-        });
-        if (!response.ok) {
-          const body = (await response.json().catch(() => null)) as {
-            error_description?: string;
-          } | null;
-          throw new Error(body?.error_description ?? `토큰 발급 실패 (HTTP ${response.status})`);
-        }
-        return clientCredentialsTokenResponseSchema.parse(unwrapData(await response.json()));
-      },
-      /** 2단계 — 소속 스토어 목록 */
+      /** 소속 스토어 목록 */
       listMyStores: () => userHttp.request("GET", "/me/stores", z.array(myStoreSchema)),
-      /** RFC 7009 — token을 폐기한다 (public client는 client_id만 동반) */
-      async revoke(token: string, clientId: string) {
-        await fetchFn(`${options.baseUrl}/oauth2/revoke`, {
-          method: "POST",
-          headers: { "content-type": "application/x-www-form-urlencoded" },
-          body: formBody({ token, client_id: clientId }),
-        });
-      },
       me: () => userHttp.request("GET", "/me", myAccountSchema),
     },
 
-    /** API 토큰(PAT) 관리 — OWNER/ADMIN 전용. 발급된 토큰은 storeToken처럼 Bearer로 사용 */
-    apiTokens: {
-      create: (body: ApiTokenCreateRequest) =>
-        storeHttp.request("POST", "/store/api-tokens", apiTokenCreatedSchema, {
-          body: apiTokenCreateRequestSchema.parse(body),
-        }),
-      list: () => storeHttp.request("GET", "/store/api-tokens", z.array(apiTokenSchema)),
-      revoke: (tokenId: string) =>
-        storeHttp.requestVoid("DELETE", path`/store/api-tokens/${tokenId}`),
-    },
-
-    /**
-     * 앱(OAuth 클라이언트) 관리 — OWNER/ADMIN storeToken 전용(PAT·M2M 거부). auth-spec §12, 부록 B-13.
-     * 시크릿 평문은 register·rotateSecret 응답에서만 한 번 노출된다(apiTokens.create와 같은 성격).
-     */
-    apiClients: {
-      /**
-       * DCR 등록 (RFC 7591) — `POST /v1/oauth2/register`. OAuth 프로토콜 표면이라 응답이 평면 JSON이다.
-       * 등록 오류(`invalid_client_metadata`·`invalid_redirect_uri`)는 ApiError(code=error,
-       * message=error_description)로, Bearer 인증 오류는 엔벨로프 그대로 ApiError로 던진다.
-       */
-      register: (body: OAuthClientRegistrationRequest) =>
-        storeHttp.request("POST", "/oauth2/register", oauthClientRegistrationResponseSchema, {
-          body: oauthClientRegistrationRequestSchema.parse(body),
-        }),
-      list: (params?: ApiClientListParams) =>
-        storeHttp.request("GET", "/store/api-clients", z.array(apiClientSchema), {
-          query: params as Query,
-        }),
-      get: (clientId: string) =>
-        storeHttp.request("GET", path`/store/api-clients/${clientId}`, apiClientSchema),
-      /** confidential 전용. 기존 시크릿은 즉시 무효(유예 없음) */
-      rotateSecret: (clientId: string) =>
-        storeHttp.request(
-          "POST",
-          path`/store/api-clients/${clientId}/rotate-secret`,
-          apiClientSecretRotatedSchema,
-        ),
-      /** REVOKED로 전환(되돌릴 수 없음). 이미 비활성이면 현재 상태를 그대로 돌려준다 */
-      deactivate: (clientId: string) =>
-        storeHttp.request("POST", path`/store/api-clients/${clientId}/deactivate`, apiClientSchema),
-    },
-
     /**
      * 미디어 업로드 — 자리를 받아(`POST /uploads`) 파일 바이트는 호출자가
      * `uploadUrl`로 직접 PUT한다. 업로드가 끝나면 `url`이 공개 주소가 된다.
@@ -1070,7 +957,7 @@ export function createStoreClient(options: StoreClientOptions) {
     /**
      * 결제(PG) 설정 — **콘솔 OWNER 전용**. ADMIN·STAFF·PAT·M2M·3rd-party 앱 토큰은 스코프가 있어도
      * 403 `INSUFFICIENT_ROLE`이다(조회 포함). OWNER 여부는 요청 시점의 스토어 멤버십으로 다시 확인하므로
-     * 양도·강등 직후의 옛 storeToken도 403이다(토큰을 재발급받는다). 비밀 값(시크릿 키·API Secret·웹훅 시크릿)은 요청으로만 보내고
+     * 양도·강등 직후에도 바로 403이다. 비밀 값(시크릿 키·API Secret·웹훅 시크릿)은 요청으로만 보내고
      * 응답에는 `secrets[].masked`(앞 4자리 마스킹)만 나온다.
      */
     paymentSettings: {
@@ -1358,12 +1245,27 @@ export function createStoreClient(options: StoreClientOptions) {
             query: { slug },
           },
         ),
-      /** `POST /v1/storefront/site` (201) — 템플릿으로 사이트를 만들고 v1을 발행한다. 공개 상태는 오픈 준비 중이다 */
+      /**
+       * `POST /v1/storefront/site` (201) — 템플릿으로 사이트를 만들고 v1을 발행한다. 공개 상태는 오픈 준비 중이다.
+       * 사이트를 만드는 유일한 경로다(스토어를 만들어도 사이트는 생기지 않는다). 템플릿은 여기서만 고른다
+       */
       create: (body: CreateStorefrontSiteRequest) =>
         storeHttp.request("POST", "/storefront/site", storefrontSiteSchema, {
           body: createStorefrontSiteRequestSchema.parse(body),
         }),
-      /** `POST /v1/storefront/site/template` — 템플릿을 바꾼다. 새 버전을 만들고 기본으로 곧바로 발행한다 */
+      /** `GET /v1/storefront/site/deployment` — 배포 진행(단계·기록). 만든 뒤 반영이 끝날 때까지 폴링한다 */
+      getDeployment: () =>
+        storeHttp.request("GET", "/storefront/site/deployment", storefrontDeploymentSchema),
+      /** `POST /v1/storefront/site/deployment/retry` (202) — 밀린 반영을 곧바로 다시 시도한다. 이미 반영됐으면 그대로다 */
+      retryDeployment: () =>
+        storeHttp.request("POST", "/storefront/site/deployment/retry", storefrontDeploymentSchema, {
+          body: {},
+        }),
+      /**
+       * `POST /v1/storefront/site/template`
+       * @deprecated 템플릿 변경은 지원하지 않는다. 서버가 항상 409 `TEMPLATE_CHANGE_NOT_SUPPORTED`로 답한다 — 템플릿은
+       * 사이트를 만들 때(`create`)만 고른다. 호환을 위해 메서드만 남겼다
+       */
       changeTemplate: (body: ChangeStorefrontTemplateRequest) =>
         storeHttp.request("POST", "/storefront/site/template", storefrontSiteSchema, {
           body: changeStorefrontTemplateRequestSchema.parse(body),
@@ -1567,6 +1469,22 @@ export function createStoreClient(options: StoreClientOptions) {
         }),
     },
 
+    subscription: {
+      /**
+       * `GET /v1/store/subscription` — 스코프 `store:r`. 현재 요금제·상태·사용량 기간·한도·이번 기간 사용량.
+       * 결제 수단·청구 금액은 싣지 않는다. 요금제 변경은 셀러 콘솔에서만 한다
+       */
+      get: () => storeHttp.request("GET", "/store/subscription", storeSubscriptionSchema),
+    },
+
+    plans: {
+      /**
+       * `GET /v1/public/plans` — 인증 없음. 공개 요금제의 지금 버전(가격·기능 키 값). 값은 서버가 관리하고 언제든 바뀔 수 있어
+       * 코드에 요금제 수치를 두지 말고 이 값을 읽는다
+       */
+      listPublic: () => storeHttp.request("GET", "/public/plans", publicPlansSchema),
+    },
+
     store: {
       get: () => storeHttp.request("GET", "/store", storeSchema),
       /**

package/src/index.ts

@@ -12,13 +12,11 @@ export {
   buildAuthorizeUrl,
   createPkcePair,
   exchangeAuthorizationCode,
-  exchangeStoreTokenViaOAuth,
   type OAuthTokenResponse,
   oauthTokenResponseSchema,
   refreshUserToken,
 } from "./oauth";
 export * from "./schemas/analytics";
-export * from "./schemas/api-client";
 export * from "./schemas/api-log";
 export * from "./schemas/audit";
 export * from "./schemas/auth";
@@ -27,6 +25,7 @@ export * from "./schemas/claim";
 export * from "./schemas/common";
 export * from "./schemas/coupon";
 export * from "./schemas/customer";
+export * from "./schemas/customer-delegation";
 export * from "./schemas/fulfillment";
 export * from "./schemas/login";
 export * from "./schemas/misc";
@@ -40,6 +39,7 @@ export * from "./schemas/scope";
 export * from "./schemas/shipping-policy";
 export * from "./schemas/store";
 export * from "./schemas/storefront-hosting";
+export * from "./schemas/subscription";
 export * from "./schemas/telemetry";
 export * from "./schemas/upload";
 export * from "./schemas/webhook-event";
@@ -48,6 +48,7 @@ export {
   createStoreSession,
   type SessionStorage,
   STORE_SESSION_KEYS,
+  type StoreAuthServer,
   type StoreSession,
   type StoreSessionOptions,
 } from "./session";

package/src/member-delegation.ts

@@ -1,9 +1,8 @@
 /**
- * 구매자 위임 — 자체 회원 시스템을 가진 셀러 서버가 로그인한 사용자를 sayren 구매자 토큰으로 바꾼다
- * (token-exchange의 `member-uid`·`member-ref` 확장, auth-spec §12-10). 클라이언트 시크릿을 쓰므로 **서버에서만** 부른다.
+ * 구매자 위임 — 자체 회원 시스템을 가진 셀러 서버가 로그인한 사용자를 sayren 구매자 토큰으로 바꾼다.
+ * 계정 토큰(개인 액세스 토큰 등)을 쓰므로 **서버에서만** 부른다.
  *
- * 스토어에 바인딩된 confidential 클라이언트 + `member:delegate` 스코프가 필요하다. 응답은 구매자 액세스 토큰(30분)이고
- * refresh는 없다 — 만료되면 같은 호출로 다시 받는다.
+ * 응답은 구매자 액세스 토큰(30분)이고 refresh는 없다 — 만료되면 같은 호출로 다시 받는다.
  */
 
 export interface DelegatedMemberToken {
@@ -12,87 +11,62 @@ export interface DelegatedMemberToken {
   memberId: string;
 }
 
-interface DelegationOptions {
-  /** api 주소(예: `https://api.sayren.app`) — `/v1/oauth2/token`을 붙인다 */
-  baseUrl: string;
-  clientId: string;
-  clientSecret: string;
-  fetch?: typeof globalThis.fetch;
-}
-
-/** 셀러 자체 인증의 사용자 id로 지목한다. 처음 보는 id면 구매자를 만든다(이메일·이름은 그때만 쓴다) */
-export function delegateMemberByUid(
-  options: DelegationOptions & {
-    uid: string;
-    email?: string;
-    name?: string;
-    /**
-     * 사용자가 내 서비스에서 실제로 로그인한 시각. 주면 구매자 토큰의 인증 시각이 되고(탈퇴처럼 최근 인증이 필요한 동작에
-     * 쓴다), 주지 않으면 인증 시각이 없는 토큰이 나온다
-     */
-    authenticatedAt?: Date;
-  },
-): Promise<DelegatedMemberToken> {
-  return delegate(options, {
-    subject_token_type: "urn:sayren:params:oauth:token-type:member-uid",
-    subject_token: options.uid,
-    ...(options.authenticatedAt
-      ? { subject_auth_time: String(Math.floor(options.authenticatedAt.getTime() / 1000)) }
-      : {}),
-    ...(options.email ? { subject_email: options.email } : {}),
-    ...(options.name ? { subject_name: options.name } : {}),
-  });
-}
-
-/** 이메일로 지목한다. 처음 보는 이메일이면 구매자를 만든다 */
-export function delegateMemberByEmail(
-  options: DelegationOptions & { email: string; name?: string },
-): Promise<DelegatedMemberToken> {
-  return delegate(options, {
-    subject_token_type: "urn:sayren:params:oauth:token-type:member-ref",
-    subject_token: options.email,
-    ...(options.name ? { subject_name: options.name } : {}),
-  });
+/** 위임 실패 — `error`는 api 오류 코드(엔벨로프 `error.code`, 없으면 `http_{status}`) */
+export class MemberDelegationError extends Error {
+  constructor(
+    readonly error: string,
+    readonly description: string,
+    readonly status: number,
+  ) {
+    super(description ? `${error}: ${description}` : error);
+    this.name = "MemberDelegationError";
+  }
 }
 
-async function delegate(
-  options: DelegationOptions,
-  subject: Record<string, string>,
-): Promise<DelegatedMemberToken> {
+/**
+ * 계정 토큰으로 구매자 위임(`POST /v1/customers/delegations`) — 계정 토큰(개인 액세스 토큰 등)과 스토어 id를 쓴다.
+ * `customer:rw`가 필요하다. `uid`(셀러 자체 인증의 사용자 id) 또는 `email`로 지목하고, 처음 보는 사용자면 구매자를 만든다.
+ */
+export async function delegateMember(options: {
+  /** api 주소(예: `https://api.sayren.app`) */
+  baseUrl: string;
+  accessToken: string;
+  storeId: string;
+  uid?: string;
+  email?: string;
+  name?: string;
+  authenticatedAt?: Date;
+  fetch?: typeof globalThis.fetch;
+}): Promise<DelegatedMemberToken> {
   const doFetch = options.fetch ?? globalThis.fetch;
-  const basic = btoa(`${options.clientId}:${options.clientSecret}`);
-  const res = await doFetch(`${options.baseUrl.replace(/\/+$/, "")}/v1/oauth2/token`, {
+  const res = await doFetch(`${options.baseUrl.replace(/\/+$/, "")}/v1/customers/delegations`, {
     method: "POST",
     headers: {
-      "content-type": "application/x-www-form-urlencoded",
-      authorization: `Basic ${basic}`,
+      "content-type": "application/json",
+      authorization: `Bearer ${options.accessToken}`,
+      "x-store-id": options.storeId,
     },
-    body: new URLSearchParams({
-      grant_type: "urn:ietf:params:oauth:grant-type:token-exchange",
-      ...subject,
-    }).toString(),
+    body: JSON.stringify({
+      ...(options.uid ? { uid: options.uid } : {}),
+      ...(options.email ? { email: options.email } : {}),
+      ...(options.name ? { name: options.name } : {}),
+      ...(options.authenticatedAt
+        ? { authenticatedAt: options.authenticatedAt.toISOString() }
+        : {}),
+    }),
   });
-  const body = (await res.json().catch(() => ({}))) as Record<string, unknown>;
-  if (!res.ok || typeof body.access_token !== "string") {
-    const error = typeof body.error === "string" ? body.error : `http_${res.status}`;
-    const description = typeof body.error_description === "string" ? body.error_description : "";
-    throw new MemberDelegationError(error, description, res.status);
+  const body = (await res.json().catch(() => ({}))) as {
+    data?: { accessToken?: unknown; expiresIn?: unknown; memberId?: unknown };
+    error?: { code?: unknown; message?: unknown };
+  };
+  if (!res.ok || typeof body.data?.accessToken !== "string") {
+    const code = typeof body.error?.code === "string" ? body.error.code : `http_${res.status}`;
+    const message = typeof body.error?.message === "string" ? body.error.message : "";
+    throw new MemberDelegationError(code, message, res.status);
   }
   return {
-    accessToken: body.access_token,
-    expiresIn: Number(body.expires_in),
-    memberId: String(body.memberId),
+    accessToken: body.data.accessToken,
+    expiresIn: Number(body.data.expiresIn),
+    memberId: String(body.data.memberId),
   };
 }
-
-/** 위임 실패 — `error`는 OAuth 오류 코드(`invalid_client`·`invalid_scope`·`invalid_request` 등) */
-export class MemberDelegationError extends Error {
-  constructor(
-    readonly error: string,
-    readonly description: string,
-    readonly status: number,
-  ) {
-    super(description ? `${error}: ${description}` : error);
-    this.name = "MemberDelegationError";
-  }
-}