sayren 0.5.0 → 0.6.1

package/dist/index.mjs

@@ -2,7 +2,7 @@
 import { spawn, spawnSync } from "node:child_process";
 import { stdin, stdout } from "node:process";
 import { createInterface } from "node:readline/promises";
-import { APP_DEPLOY_KEY_PATTERN, APP_SECRET_PATTERNS, APP_SERVER_BUNDLE_MAX_GZIP_BYTES, APP_UI_MAX_BYTES, APP_UI_MAX_FILES, ApiError, ApprovalPendingError, STOREFRONT_BUILD_TERMINAL_STATUSES, STOREFRONT_SOURCE_BLOB_BATCH_MAX, appManifestProblems, appManifestSchema, createStoreClient, normalizeStorefrontPath } from "@sayren/store-sdk";
+import { APP_DEPLOY_KEY_PATTERN, APP_README_MAX_BYTES, APP_SECRET_PATTERNS, APP_SERVER_BUNDLE_MAX_GZIP_BYTES, APP_UI_MAX_BYTES, APP_UI_MAX_FILES, ApiError, ApprovalPendingError, STOREFRONT_BUILD_TERMINAL_STATUSES, STOREFRONT_SOURCE_BLOB_BATCH_MAX, appIconProblem, appManifestProblems, appManifestSchema, createStoreClient, normalizeStorefrontPath } from "@sayren/store-sdk";
 import { chmodSync, closeSync, existsSync, lstatSync, mkdirSync, openSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { createServer } from "node:http";
 import { dirname, extname, join, relative, resolve, sep } from "node:path";
@@ -1067,6 +1067,42 @@ const cli_app_handler_unlisted = ((inputs, options = {}) => {
 	return ko_cli_app_handler_unlisted(inputs);
 });
 
+//#endregion
+//#region ../i18n/src/paraglide/messages/cli_app_icon_invalid.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{ path: NonNullable<unknown>, problem: NonNullable<unknown> }} Cli_App_Icon_InvalidInputs */
+const ko_cli_app_icon_invalid = (i) => {
+	return `아이콘을 쓸 수 없습니다(${i?.path}): ${i?.problem}`;
+};
+/**
+
+* @param {Cli_App_Icon_InvalidInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const cli_app_icon_invalid = ((inputs, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_cli_app_icon_invalid(inputs);
+});
+
+//#endregion
+//#region ../i18n/src/paraglide/messages/cli_app_icon_missing.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{ path: NonNullable<unknown> }} Cli_App_Icon_MissingInputs */
+const ko_cli_app_icon_missing = (i) => {
+	return `매니페스트 icon의 파일이 없습니다: ${i?.path}`;
+};
+/**
+
+* @param {Cli_App_Icon_MissingInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const cli_app_icon_missing = ((inputs, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_cli_app_icon_missing(inputs);
+});
+
 //#endregion
 //#region ../i18n/src/paraglide/messages/cli_app_init_done.js
 /** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
@@ -1108,6 +1144,24 @@ const cli_app_key_invalid = ((inputs = {}, options = {}) => {
 	return ko_cli_app_key_invalid(inputs);
 });
 
+//#endregion
+//#region ../i18n/src/paraglide/messages/cli_app_listing_none.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{}} Cli_App_Listing_NoneInputs */
+const ko_cli_app_listing_none = () => {
+	return `없음`;
+};
+/**
+
+* @param {Cli_App_Listing_NoneInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const cli_app_listing_none = ((inputs = {}, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_cli_app_listing_none(inputs);
+});
+
 //#endregion
 //#region ../i18n/src/paraglide/messages/cli_app_logs_empty.js
 /** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
@@ -1199,6 +1253,42 @@ const cli_app_port_invalid = ((inputs, options = {}) => {
 	return ko_cli_app_port_invalid(inputs);
 });
 
+//#endregion
+//#region ../i18n/src/paraglide/messages/cli_app_readme_missing.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{ path: NonNullable<unknown> }} Cli_App_Readme_MissingInputs */
+const ko_cli_app_readme_missing = (i) => {
+	return `매니페스트 readme의 파일이 없습니다: ${i?.path}`;
+};
+/**
+
+* @param {Cli_App_Readme_MissingInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const cli_app_readme_missing = ((inputs, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_cli_app_readme_missing(inputs);
+});
+
+//#endregion
+//#region ../i18n/src/paraglide/messages/cli_app_readme_too_large.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{ limit: NonNullable<unknown>, path: NonNullable<unknown> }} Cli_App_Readme_Too_LargeInputs */
+const ko_cli_app_readme_too_large = (i) => {
+	return `README가 ${i?.limit}KB를 넘습니다: ${i?.path}`;
+};
+/**
+
+* @param {Cli_App_Readme_Too_LargeInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const cli_app_readme_too_large = ((inputs, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_cli_app_readme_too_large(inputs);
+});
+
 //#endregion
 //#region ../i18n/src/paraglide/messages/cli_app_release_done.js
 /** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
@@ -1512,9 +1602,9 @@ const cli_app_uploading = ((inputs, options = {}) => {
 //#endregion
 //#region ../i18n/src/paraglide/messages/cli_app_verify_ok.js
 /** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
-/** @typedef {{ events: NonNullable<unknown>, http: NonNullable<unknown>, size: NonNullable<unknown>, ui: NonNullable<unknown> }} Cli_App_Verify_OkInputs */
+/** @typedef {{ events: NonNullable<unknown>, http: NonNullable<unknown>, size: NonNullable<unknown>, ui: NonNullable<unknown>, icon: NonNullable<unknown>, readme: NonNullable<unknown> }} Cli_App_Verify_OkInputs */
 const ko_cli_app_verify_ok = (i) => {
-	return `검사 통과 — 이벤트 ${i?.events} · HTTP ${i?.http} · 서버 번들 ${i?.size}(gzip) · 화면 파일 ${i?.ui}개`;
+	return `검사 통과 — 이벤트 ${i?.events} · HTTP ${i?.http} · 서버 번들 ${i?.size}(gzip) · 화면 파일 ${i?.ui}개 · 아이콘 ${i?.icon} · README ${i?.readme}`;
 };
 /**
 
@@ -9087,7 +9177,7 @@ async function selectStore(auth, client, io, candidates, folderStore = null) {
 
 //#endregion
 //#region package.json
-var version = "0.5.0";
+var version = "0.6.1";
 
 //#endregion
 //#region src/client.ts
@@ -9305,6 +9395,42 @@ async function loadBundle(dir, server) {
 		}
 	};
 }
+function collectListing(dir, manifest) {
+	let icon = null;
+	if (manifest.icon) {
+		const file = join(dir, manifest.icon);
+		if (!existsSync(file)) throw new CliError(cli_app_icon_missing({ path: manifest.icon }));
+		const bytes = readFileSync(file);
+		const contentType = /\.svg$/i.test(manifest.icon) ? "image/svg+xml" : "image/png";
+		const problem = appIconProblem(bytes, contentType);
+		if (problem) throw new CliError(cli_app_icon_invalid({
+			path: manifest.icon,
+			problem
+		}));
+		icon = {
+			path: manifest.icon,
+			contentType,
+			bytes
+		};
+	}
+	const readmePath = manifest.readme ?? "README.md";
+	let readme = null;
+	if (existsSync(join(dir, readmePath))) {
+		const text = readFileSync(join(dir, readmePath), "utf8");
+		if (Buffer.byteLength(text, "utf8") > APP_README_MAX_BYTES) throw new CliError(cli_app_readme_too_large({
+			path: readmePath,
+			limit: String(APP_README_MAX_BYTES / 1024)
+		}));
+		readme = {
+			path: readmePath,
+			text
+		};
+	} else if (manifest.readme) throw new CliError(cli_app_readme_missing({ path: manifest.readme }));
+	return {
+		icon,
+		readme
+	};
+}
 /** 로컬 검사 — 매니페스트, 번들, 이벤트 함수 존재, 비밀 값 형식, 크기. 서버 `VERIFY`·`BUNDLE`과 같은 규칙 */
 async function verifyApp(dir) {
 	const { raw, manifest } = loadManifest(dir);
@@ -9321,6 +9447,7 @@ async function verifyApp(dir) {
 	if (extra.length) warnings.push(cli_app_handler_unlisted({ events: extra.join(", ") }));
 	const ui = manifest.ui?.adminPage ? collectUi(dir) : [];
 	if (manifest.ui?.adminPage && !ui.some((file) => file.path === "index.html")) throw new CliError(cli_app_ui_index_missing({ dir: UI_DIR }));
+	const listing = collectListing(dir, manifest);
 	return {
 		manifest,
 		raw,
@@ -9331,6 +9458,7 @@ async function verifyApp(dir) {
 		},
 		app,
 		ui,
+		listing,
 		warnings
 	};
 }
@@ -9408,14 +9536,15 @@ function initFiles(handle, name) {
 export default defineApp({
   events: {
     "ORDER.PAID": async (event, ctx) => {
-      const { orderId } = event.data as { orderId: string };
-      const order = await ctx.api.orders.get(orderId);
-      ctx.log.info("결제된 주문", order.orderNo, order.totalAmount);
+      // event.data는 ORDER.PAID의 모양으로 좁혀진다 — 캐스팅하지 않는다
+      const order = await ctx.api.orders.get(event.data.orderId);
+      ctx.log.info("결제된 주문", order.orderNo, order.payment.totalAmount);
     },
   },
 });
 `,
 		".gitignore": "node_modules/\ndist/\n.env\n.sayren/\n",
+		"README.md": `# ${name}\n\n이 앱이 하는 일을 한두 문장으로 씁니다.\n\n## 설정\n\n설치한 뒤 채울 설정을 설명합니다.\n`,
 		".env.example": `# 로컬 실행(sayren app dev)의 설정·비밀 값\n# ${SETTING_ENV_PREFIX}<설정 키>=값\n# ${SECRET_ENV_PREFIX}<비밀 값 이름>=값\n`
 	};
 }
@@ -9454,7 +9583,9 @@ async function appVerify(flags, io) {
 		events: outcome.bundle.meta.events.join(", ") || "-",
 		http: outcome.bundle.meta.http.join(", ") || "-",
 		size: formatMb(outcome.bundle.gzipBytes),
-		ui: String(outcome.ui.length)
+		ui: String(outcome.ui.length),
+		icon: outcome.listing.icon?.path ?? cli_app_listing_none(),
+		readme: outcome.listing.readme?.path ?? cli_app_listing_none()
 	}));
 	return 0;
 }
@@ -9486,6 +9617,13 @@ async function appDeploy(flags, io) {
 			path: file.path,
 			content: file.bytes.toString("base64")
 		})),
+		listing: {
+			icon: outcome.listing.icon ? {
+				contentType: outcome.listing.icon.contentType,
+				content: outcome.listing.icon.bytes.toString("base64")
+			} : null,
+			readme: outcome.listing.readme?.text ?? null
+		},
 		...flags.message ? { message: flags.message } : {}
 	});
 	printBuild(version$1, io);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sayren",
-  "version": "0.5.0",
+  "version": "0.6.1",
   "type": "module",
   "description": "sayren CLI — 호스팅 스토어프론트(init·pull·deploy)와 서드파티 앱(app init·dev·deploy·release)",
   "bin": {
@@ -14,7 +14,7 @@
   },
   "dependencies": {
     "esbuild": "^0.28.2",
-    "@sayren/store-sdk": "^0.30.8"
+    "@sayren/store-sdk": "^0.30.11"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.5.14",