storelingo 0.5.0 → 0.5.1

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.5.1 — 2026-11-15
+
+- `stores.appstore.appId` is needed only for `pull` and `push`. `translate` and `check` work with `"appstore": {}` before the app exists in App Store Connect, and `init` accepts an empty Apple ID. `pull` / `push` without it stop with a clear `E_CONFIG` before any network call (found while localizing a real app).
+
 ## 0.5.0 — 2026-11-15
 
 - First release on npm: `npx storelingo` works without building from source.

package/README.md

@@ -96,7 +96,8 @@ For Google Play, the newest changelog (highest version code) of the source local
 | `sourceLocale` | yes | storelingo locale code of your source texts, e.g. `en-US`. |
 | `targetLocales` | yes | Non-empty list of storelingo locale codes to translate into, without duplicates. |
 | `stores.play.packageName` | one store required | Enables Google Play. |
-| `stores.appstore.appId` | one store required | Enables the App Store. The numeric Apple ID of the app. |
+| `stores.appstore` | one store required | Enables the App Store. `{}` is enough for `translate` and `check`, even before the app exists in App Store Connect. |
+| `stores.appstore.appId` | for `pull` / `push` | The numeric Apple ID of the app (App Store Connect → App Information). |
 | `stores.appstore.platform` | no (default `IOS`) | `IOS`, `MAC_OS`, `TV_OS` or `VISION_OS`: the platform whose version storelingo works with. |
 | `translator.provider` | yes | `anthropic` or `openai-compatible`. |
 | `translator.model` | `anthropic`: no (default `claude-opus-5-5`); `openai-compatible`: yes | Model name. |
@@ -242,7 +243,7 @@ How it behaves:
 
 ## GitHub Action
 
-Run storelingo in CI with `uses: Alisher23/storelingo@v0.4.1` (pin a release tag or a commit SHA). It can translate on push and commit the result, or only run the offline `check` on pull requests with no secrets. See the [GitHub Action guide](https://github.com/Alisher23/storelingo/blob/main/docs/github-action.md) for workflows, inputs and security notes.
+Run storelingo in CI with `uses: Alisher23/storelingo@v0.5.1` (pin a release tag or a commit SHA). It can translate on push and commit the result, or only run the offline `check` on pull requests with no secrets. See the [GitHub Action guide](https://github.com/Alisher23/storelingo/blob/main/docs/github-action.md) for workflows, inputs and security notes.
 
 ## How translation works
 

package/README.ru.md

@@ -96,7 +96,8 @@ fastlane/metadata/                  # App Store (fastlane deliver)
 | `sourceLocale` | да | Код локали storelingo для исходных текстов, например `en-US`. |
 | `targetLocales` | да | Непустой список кодов локалей storelingo, на которые переводить, без повторов. |
 | `stores.play.packageName` | нужен хотя бы один магазин | Включает Google Play. |
-| `stores.appstore.appId` | нужен хотя бы один магазин | Включает App Store. Числовой Apple ID приложения. |
+| `stores.appstore` | нужен хотя бы один магазин | Включает App Store. Для `translate` и `check` достаточно `{}`, даже если приложения ещё нет в App Store Connect. |
+| `stores.appstore.appId` | для `pull` / `push` | Числовой Apple ID приложения (App Store Connect → App Information). |
 | `stores.appstore.platform` | нет (по умолчанию `IOS`) | `IOS`, `MAC_OS`, `TV_OS` или `VISION_OS`: платформа, с версией которой работает storelingo. |
 | `translator.provider` | да | `anthropic` или `openai-compatible`. |
 | `translator.model` | `anthropic`: нет (по умолчанию `claude-opus-5-5`); `openai-compatible`: да | Название модели. |
@@ -242,7 +243,7 @@ npx storelingo push --store appstore
 
 ## GitHub Action
 
-Запускайте storelingo в CI через `uses: Alisher23/storelingo@v0.4.1` (закрепляйте релизный тег или SHA коммита). Он может переводить при push и коммитить результат либо только запускать офлайн-проверку `check` в pull request'ах без секретов. Workflow, параметры и заметки по безопасности смотрите в [руководстве по GitHub Action](https://github.com/Alisher23/storelingo/blob/main/docs/github-action.ru.md).
+Запускайте storelingo в CI через `uses: Alisher23/storelingo@v0.5.1` (закрепляйте релизный тег или SHA коммита). Он может переводить при push и коммитить результат либо только запускать офлайн-проверку `check` в pull request'ах без секретов. Workflow, параметры и заметки по безопасности смотрите в [руководстве по GitHub Action](https://github.com/Alisher23/storelingo/blob/main/docs/github-action.ru.md).
 
 ## Как работает перевод
 

package/dist/cli/main.js

@@ -28,12 +28,14 @@ const defaultTranslator = (config, env) => createTranslator(createLlmClient(conf
 const pkg = createRequire(import.meta.url)("../../package.json");
 const defaultMakeStore = async (store, config, env) => {
     if (store === "appstore") {
-        if (!config.stores.appstore)
-            throw new StorelingoError("E_CONFIG", "stores.appstore is not configured");
+        const appId = config.stores.appstore?.appId;
+        if (!config.stores.appstore || appId === undefined) {
+            throw new StorelingoError("E_CONFIG", "stores.appstore.appId is required for pull and push");
+        }
         const key = await loadAscKey(env);
         const tokens = createAscTokenProvider({ key });
         const api = createAscApi({ getToken: () => tokens.getToken() });
-        return createAppStoreStore(api, { appId: config.stores.appstore.appId, platform: config.stores.appstore.platform });
+        return createAppStoreStore(api, { appId, platform: config.stores.appstore.platform });
     }
     if (!config.stores.play)
         throw new StorelingoError("E_CONFIG", "stores.play is not configured");
@@ -44,6 +46,13 @@ const defaultMakeStore = async (store, config, env) => {
 };
 /** Validated before any network call; without --store every configured store runs (play, then appstore). */
 function selectStores(option, config) {
+    const stores = selectConfiguredStores(option, config);
+    if (stores.includes("appstore") && config.stores.appstore?.appId === undefined) {
+        throw new StorelingoError("E_CONFIG", "stores.appstore.appId is required for pull and push", "Add the numeric Apple ID from App Store Connect (App Information) as stores.appstore.appId in storelingo.config.json, or use --store play.");
+    }
+    return stores;
+}
+function selectConfiguredStores(option, config) {
     if (option === undefined)
         return configuredStores(config);
     if (option !== "play" && option !== "appstore") {

package/dist/commands/init.js

@@ -10,8 +10,8 @@ export function buildConfigJson(a) {
     const stores = {};
     if (a.playPackageName)
         stores.play = { packageName: a.playPackageName };
-    if (a.appstoreAppId)
-        stores.appstore = { appId: a.appstoreAppId };
+    if (a.appstore)
+        stores.appstore = a.appstore.appId ? { appId: a.appstore.appId } : {};
     const translator = a.provider === "anthropic"
         ? { provider: "anthropic", ...(a.model ? { model: a.model } : {}) }
         : { provider: "openai-compatible", baseUrl: a.baseUrl, model: a.model };
@@ -87,13 +87,16 @@ export async function promptInitAnswers() {
     const playPackageName = stores.includes("play")
         ? await input({ message: "Google Play package name (e.g. com.example.app)", required: true })
         : undefined;
-    const appstoreAppId = stores.includes("appstore")
-        ? (await input({
-            message: "App Store app ID (numbers from App Store Connect)",
-            required: true,
-            validate: (v) => /^[0-9]+$/.test(v.trim()) || "Enter the numeric Apple ID from App Store Connect (App Information)",
-        })).trim()
-        : undefined;
+    let appstore;
+    if (stores.includes("appstore")) {
+        const appId = (await input({
+            message: "App Store app ID (numbers from App Store Connect; leave empty if the app is not there yet)",
+            validate: (v) => v.trim() === "" ||
+                /^[0-9]+$/.test(v.trim()) ||
+                "Enter the numeric Apple ID from App Store Connect (App Information), or leave it empty",
+        })).trim();
+        appstore = appId ? { appId } : {};
+    }
     const provider = await select({
         message: "Translator",
         choices: [
@@ -106,5 +109,5 @@ export async function promptInitAnswers() {
         : undefined;
     const model = provider === "openai-compatible" ? await input({ message: "Model name", required: true }) : undefined;
     const context = await input({ message: "One sentence about your app (helps the translator)", default: "" });
-    return { sourceLocale, targetLocales, playPackageName, appstoreAppId, provider, baseUrl, model, context };
+    return { sourceLocale, targetLocales, playPackageName, appstore, provider, baseUrl, model, context };
 }

package/dist/config/schema.js

@@ -31,7 +31,8 @@ export const ConfigSchema = z.strictObject({
         play: z.strictObject({ packageName: z.string().min(1) }).optional(),
         appstore: z
             .strictObject({
-            appId: z.string().regex(/^\d+$/, "must be the numeric Apple ID of the app"),
+            // Needed only for pull and push: translate and check work before the app exists in App Store Connect.
+            appId: z.string().regex(/^\d+$/, "must be the numeric Apple ID of the app").optional(),
             platform: z.enum(["IOS", "MAC_OS", "TV_OS", "VISION_OS"]).default("IOS"),
         })
             .optional(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "storelingo",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "AI localization for Google Play and App Store listings. Reads and writes fastlane metadata.",
   "homepage": "https://github.com/Alisher23/storelingo#readme",
   "bugs": {