@stacksjs/browser-extension 0.70.380 → 0.71.2

package/dist/index.d.ts

@@ -16,6 +16,7 @@ export * from './firefox-addons';
 export * from './firefox-previews';
 export * from './manifest';
 export * from './package';
+export * from './publish-plan';
 export * from './safari';
 export * from './scaffold';
 export * from './sanitize';

package/dist/index.js

@@ -1 +1 @@
-export*from"./build";export*from"./app-store-connect";export*from"./app-store-submission";export*from"./chrome-web-store";export*from"./config";export*from"./firefox-addons";export*from"./firefox-previews";export*from"./manifest";export*from"./package";export*from"./safari";export*from"./scaffold";export*from"./sanitize";export*from"./types";
+export*from"./build";export*from"./app-store-connect";export*from"./app-store-submission";export*from"./chrome-web-store";export*from"./config";export*from"./firefox-addons";export*from"./firefox-previews";export*from"./manifest";export*from"./package";export*from"./publish-plan";export*from"./safari";export*from"./scaffold";export*from"./sanitize";export*from"./types";

package/dist/publish-plan.d.ts

@@ -0,0 +1,23 @@
+import type { ExtensionConfig, ExtensionTarget } from './types';
+/** Whether the project declares this store at all. */
+export declare function isTargetConfigured(config: ExtensionConfig, target: ExtensionTarget): boolean;
+/** The credential variables a configured target still needs, if any. */
+export declare function missingCredentials(target: ExtensionTarget, env: PublishEnv): string[];
+/**
+ * Decide what a release publishes. Targets are always returned in a stable
+ * order, including the skipped ones, so the release log shows the whole
+ * picture rather than only what happened to run.
+ */
+export declare function planExtensionPublish(config: ExtensionConfig, env?: PublishEnv, targets?: readonly ExtensionTarget[]): PublishDecision[];
+/** One line per target, for the release log. */
+export declare function formatPublishPlan(decisions: readonly PublishDecision[]): string;
+export declare interface PublishDecision {
+  target: ExtensionTarget
+  publish: boolean
+  reason?: PublishSkipReason
+  detail?: string
+}
+/** Why a target is not being published. */
+export type PublishSkipReason = 'not-configured' | 'missing-credentials';
+/** The environment a plan is resolved against; `process.env` in practice. */
+export type PublishEnv = Record<string, string | undefined>;

package/dist/publish-plan.js

@@ -0,0 +1,2 @@
+const credentialRequirements={chrome:[["CHROME_WEB_STORE_SERVICE_ACCOUNT_PATH","CHROME_WEB_STORE_ACCESS_TOKEN","GOOGLE_APPLICATION_CREDENTIALS"]],firefox:[["AMO_JWT_ISSUER","WEB_EXT_API_KEY"],["AMO_JWT_SECRET","WEB_EXT_API_SECRET"]],safari:[["APP_STORE_CONNECT_API_KEY_ID"],["APP_STORE_CONNECT_API_ISSUER_ID"],["APP_STORE_CONNECT_API_KEY_PATH"]]};export function isTargetConfigured(config,target){if(target==="chrome")return Boolean(config.chromeWebStore?.itemId);if(target==="firefox")return Boolean(config.firefoxAddons&&config.geckoId);return Boolean(config.safariBundleId&&config.safariTeamId)}export function missingCredentials(target,env){return credentialRequirements[target].filter((alternatives)=>!alternatives.some((name)=>(env[name]??"").trim()!=="")).map((alternatives)=>alternatives[0])}export function planExtensionPublish(config,env=process.env,targets=["chrome","firefox","safari"]){return targets.map((target)=>{if(!isTargetConfigured(config,target))return{target,publish:!1,reason:"not-configured",detail:`no ${configKeyFor(target)} in config/extension.ts`};const missing=missingCredentials(target,env);if(missing.length)return{target,publish:!1,reason:"missing-credentials",detail:`set ${missing.join(", ")}`};return{target,publish:!0}})}function configKeyFor(target){if(target==="chrome")return"chromeWebStore.itemId";if(target==="firefox")return"firefoxAddons + geckoId";return"safariBundleId + safariTeamId"}export function formatPublishPlan(decisions){return decisions.map((decision)=>{if(decision.publish)return`  ${decision.target}: publishing`;return`  ${decision.target}: skipped (${decision.detail??decision.reason})`}).join(`
+`)}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/browser-extension",
   "type": "module",
-  "version": "0.70.380",
+  "version": "0.71.2",
   "description": "Build MV3 browser extensions (Chrome, Firefox, Safari) the Stacks way — manifest, content/background scripts, DNR rules, packaging, Safari container app, all config-driven.",
   "author": "Chris Breuer",
   "contributors": [
@@ -58,7 +58,7 @@
     "safari-template"
   ],
   "dependencies": {
-    "ts-pantry": "^0.11.0"
+    "ts-pantry": "^0.11.27"
   },
   "scripts": {
     "build": "bun build.ts",
@@ -74,6 +74,6 @@
     }
   },
   "devDependencies": {
-    "better-dx": "^0.2.17"
+    "better-dx": "^0.2.23"
   }
 }