@tantawowa/hosanna-tools 3.14.1 → 3.15.1

package/README.md

@@ -303,9 +303,19 @@ Bare `hst run` in an interactive terminal discovers runnable web previews, vendo
 ### Roku Commands (`roku:*`) - Roku Deployment & Packaging
 - `roku:run` - Deploy a Roku app to a device (supports .zip file or folder)
 - `roku:command` - Send a Hosanna command to an installed channel through Roku ECP
-- `roku:package` - Package and sign a Roku channel using roku-deploy
+- `roku:package` - Package and sign a Roku channel using roku-deploy. Source zips over 4 MiB warn by default; signed packages over 4 MiB fail.
 - `roku:map-stack` - Resolve Roku `.brs` stack traces, compile errors, and crash snippets to original TypeScript locations using `.brs.map` files
 
+The package-size limit defaults to Roku's 4 MiB certification limit. Set a different
+limit with `--max-pkg-size-mb`, or explicitly allow an oversized signed package with
+`--ignorePkgTooBig` (`--ignore-pkg-too-big` is equivalent). Oversized source zips
+remain warnings because the signed `.pkg` is the release artifact Roku certifies.
+
+```bash
+hst roku:package --max-pkg-size-mb 4
+hst roku:package --ignorePkgTooBig
+```
+
 Send a command to the sideloaded `dev` channel (the default app ID):
 
 ```bash
@@ -585,7 +595,7 @@ hst generate:all --watch          # Generate code with file watching
 hst dev:start                    # Lower-level dev server task used by hst run
 
 # Building and packaging
-hst roku:package --ip 192.168.1.10  # Package and deploy Roku app
+hst roku:package --ip 192.168.1.10  # Package and deploy; signed .pkg must be <= 4 MiB
 hst generate:clean              # Clean generated files
 
 # Setup and installation

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
-  "buildDate": "2026-08-05T12:31:10+00:00",
-  "buildDateISO": "2026-08-05T12:31:10.889Z",
+  "buildDate": "2026-08-08T04:51:31+00:00",
+  "buildDateISO": "2026-08-08T04:51:31.428Z",
   "timeZone": "UTC",
-  "gitHash": "040bff3"
+  "gitHash": "e37f03d"
 }

package/dist/cli.js

@@ -234,7 +234,15 @@ function rememberedExplicitDestination(plan, hasExplicitDestination) {
         return undefined;
     return Object.assign({ platform: plan.resolved.platform, target }, (plan.resolved.deviceSelector ? { device: plan.resolved.deviceSelector } : {}));
 }
-const NATIVE_PLATFORM_CHOICES = ['apple', 'ios', 'apple-tv', 'android', 'android-tv', 'all'];
+const NATIVE_PLATFORM_CHOICES = [
+    'apple', 'ios', 'apple-tv', 'carplay', 'apple-watch', 'watchos',
+    'android', 'android-tv', 'android-auto', 'wear-os', 'wearos', 'android-watch',
+    'cars', 'watches', 'all',
+];
+const RUN_PLATFORM_CHOICES = [
+    'web', 'roku', 'ios', 'apple-tv', 'carplay', 'apple-watch', 'watchos',
+    'android', 'android-tv', 'android-auto', 'wear-os', 'wearos', 'android-watch',
+];
 function nativeInputFromArgs(args) {
     return {
         cwd: process.cwd(),
@@ -244,8 +252,11 @@ function nativeInputFromArgs(args) {
         bundleId: stringArg(args['bundle-id']),
         iosBundleId: stringArg(args['ios-bundle-id']),
         appleTvBundleId: stringArg(args['apple-tv-bundle-id']),
+        appleWatchBundleId: stringArg(args['apple-watch-bundle-id']),
         androidPackage: stringArg(args['android-package']),
         androidTvPackage: stringArg(args['android-tv-package']),
+        androidAutoPackage: stringArg(args['android-auto-package']),
+        wearOsPackage: stringArg(args['wear-os-package']),
         teamId: stringArg(args['team-id']),
         versionName: stringArg(args['version-name']),
         versionCode: numberOrStringArg(args['version-code']),
@@ -656,8 +667,11 @@ catch (err) {
     .option('bundle-id', { type: 'string', describe: 'Base bundle/package identifier' })
     .option('ios-bundle-id', { type: 'string', describe: 'iOS bundle identifier' })
     .option('apple-tv-bundle-id', { type: 'string', describe: 'tvOS bundle identifier' })
+    .option('apple-watch-bundle-id', { type: 'string', describe: 'watchOS bundle identifier' })
     .option('android-package', { type: 'string', describe: 'Android namespace and phone package base' })
     .option('android-tv-package', { type: 'string', describe: 'Android TV application id' })
+    .option('android-auto-package', { type: 'string', describe: 'Android Auto application id' })
+    .option('wear-os-package', { type: 'string', describe: 'Wear OS application id' })
     .option('team-id', { type: 'string', describe: 'Apple development team id for generated xcconfig files' })
     .option('version-name', { type: 'string', describe: 'Native marketing/versionName value' })
     .option('version-code', { type: 'number', describe: 'Native build/versionCode value' })
@@ -667,6 +681,7 @@ catch (err) {
     .option('format', { type: 'string', choices: ['text', 'json'], default: 'text', describe: 'Output format' })
     .option('non-interactive', { type: 'boolean', default: false, describe: 'Fail instead of prompting when a decision is needed' })
     .example('$0 native:init all --display-name "Hope Stream"', 'Initialize Apple and Android app-owned native projects')
+    .example('$0 native:init watches --display-name "Hope Stream"', 'Initialize Apple Watch and Wear OS native targets')
     .example('$0 native:init android-tv --dry-run --format json', 'Preview Android TV native setup as JSON'), async (args) => {
     try {
         const mod = await Promise.resolve().then(() => __importStar(require('./native/native-project.js')));
@@ -700,8 +715,11 @@ catch (err) {
     .option('bundle-id', { type: 'string', describe: 'Base bundle/package identifier' })
     .option('ios-bundle-id', { type: 'string', describe: 'iOS bundle identifier' })
     .option('apple-tv-bundle-id', { type: 'string', describe: 'tvOS bundle identifier' })
+    .option('apple-watch-bundle-id', { type: 'string', describe: 'watchOS bundle identifier' })
     .option('android-package', { type: 'string', describe: 'Android namespace and phone package base' })
     .option('android-tv-package', { type: 'string', describe: 'Android TV application id' })
+    .option('android-auto-package', { type: 'string', describe: 'Android Auto application id' })
+    .option('wear-os-package', { type: 'string', describe: 'Wear OS application id' })
     .option('team-id', { type: 'string', describe: 'Apple development team id for generated xcconfig files' })
     .option('version-name', { type: 'string', describe: 'Native marketing/versionName value' })
     .option('version-code', { type: 'number', describe: 'Native build/versionCode value' })
@@ -731,8 +749,11 @@ catch (err) {
     .option('bundle-id', { type: 'string', describe: 'Base bundle/package identifier' })
     .option('ios-bundle-id', { type: 'string', describe: 'iOS bundle identifier' })
     .option('apple-tv-bundle-id', { type: 'string', describe: 'tvOS bundle identifier' })
+    .option('apple-watch-bundle-id', { type: 'string', describe: 'watchOS bundle identifier' })
     .option('android-package', { type: 'string', describe: 'Android namespace and phone package base' })
     .option('android-tv-package', { type: 'string', describe: 'Android TV application id' })
+    .option('android-auto-package', { type: 'string', describe: 'Android Auto application id' })
+    .option('wear-os-package', { type: 'string', describe: 'Wear OS application id' })
     .option('team-id', { type: 'string', describe: 'Apple development team id for generated xcconfig files' })
     .option('version-name', { type: 'string', describe: 'Native marketing/versionName value' })
     .option('version-code', { type: 'number', describe: 'Native build/versionCode value' })
@@ -766,6 +787,8 @@ catch (err) {
     .option('rootDir', { type: 'string', describe: 'Roku project root (default: ./platforms/roku/src)' })
     .option('outDir', { type: 'string', describe: 'Output directory (default: ./build)' })
     .option('prebuild', { type: 'string', describe: 'Shell command to run before packaging (e.g. "npm run transpile:prod")' })
+    .option('max-pkg-size-mb', { alias: 'maxPkgSizeMb', type: 'number', default: 4, describe: 'Maximum signed Roku .pkg size in MiB (default: Roku 4 MiB certification limit)' })
+    .option('ignore-pkg-too-big', { alias: 'ignorePkgTooBig', type: 'boolean', default: false, describe: 'Warn instead of failing when the signed .pkg exceeds the size limit' })
     .option('quiet', { type: 'boolean', default: false, describe: 'Reduce output; print only errors and success' })
     .example('$0 roku:package --ip 192.168.1.10 --installer-password secret --dev-id ABC --signing-password sss --key-pkg mykey.pkg', 'Package and sign with explicit args')
     .example('$0 roku:package --key-pkg-base64 <base64-string>', 'Package using base64-encoded key package')
@@ -787,6 +810,8 @@ catch (err) {
             rootDir: args.rootDir,
             outDir: args.outDir,
             prebuild: args.prebuild,
+            maxPkgSizeMb: args['max-pkg-size-mb'],
+            ignorePkgTooBig: Boolean(args['ignore-pkg-too-big']),
             quiet: Boolean(args.quiet),
             dotenv: true,
         });
@@ -1779,12 +1804,12 @@ catch (err) {
     .command('target:list [platform]', 'List run targets discovered by hst, including web emulators, sims, and physical devices', yargs => yargs
     .positional('platform', {
     type: 'string',
-    choices: ['web', 'roku', 'ios', 'apple-tv', 'android', 'android-tv'],
+    choices: RUN_PLATFORM_CHOICES,
     describe: 'Filter by launch platform',
 })
     .option('platform', {
     type: 'string',
-    choices: ['web', 'roku', 'ios', 'apple-tv', 'android', 'android-tv'],
+    choices: RUN_PLATFORM_CHOICES,
     describe: 'Filter by launch platform',
 })
     .option('target', {
@@ -1794,7 +1819,7 @@ catch (err) {
 })
     .option('form-factor', {
     type: 'string',
-    choices: ['desktop', 'mobile', 'tablet', 'tv'],
+    choices: ['desktop', 'mobile', 'tablet', 'tv', 'car', 'watch'],
     describe: 'Filter by form factor for broad agent inventory queries',
 })
     .option('json', {
@@ -1816,6 +1841,8 @@ catch (err) {
     .example('$0 target:list --platform android --target device --json', 'List physical Android device targets as JSON')
     .example('$0 target:list --platform android-tv --target sim --json', 'List Android TV emulator targets as JSON')
     .example('$0 target:list --platform apple-tv --target sim --json', 'List Apple TV simulator targets as JSON')
+    .example('$0 target:list --platform apple-watch --target sim --json', 'List Apple Watch simulator targets as JSON')
+    .example('$0 target:list --platform wear-os --target sim --json', 'List Wear OS emulator targets as JSON')
     .example('$0 target:list --form-factor tv --json', 'List TV-class targets as JSON'), async (args) => {
     try {
         const mod = await Promise.resolve().then(() => __importStar(require('./run/targets.js')));
@@ -1859,7 +1886,7 @@ catch (err) {
 })
     .option('platform', {
     type: 'string',
-    choices: ['web', 'roku', 'ios', 'apple-tv', 'android', 'android-tv'],
+    choices: RUN_PLATFORM_CHOICES,
     describe: 'Build platform.',
 })
     .option('env', {
@@ -1906,10 +1933,12 @@ catch (err) {
     .example('$0 build roku dev device', 'Build the dev Roku output without deploying or streaming logs')
     .example('$0 build roku prod device --hsc-project platforms/hsconfig-roku.prod.json', 'Build Roku with an explicit HSC project file')
     .example('$0 build ios dev sim --device "iPhone 17 Pro"', 'Build an iOS simulator target without install, launch, or logs')
+    .example('$0 build apple-watch dev sim --device "Apple Watch Series 11 (46mm)"', 'Build the paired Apple Watch simulator target')
+    .example('$0 build wear-os dev sim --device "Wear_OS_Large_Round"', 'Build the Wear OS emulator target')
     .example('$0 build web dev emulator', 'Resolve web runtime build config without opening a browser'), async (args) => {
     await runRunPlanCommand('build', args);
 })
-    .command('run [platform] [env] [target] [deviceSelector]', 'Launch a Hosanna app on a platform target (web, Roku, iOS, Apple TV, Android, and Android TV targets are supported)', yargs => yargs
+    .command('run [platform] [env] [target] [deviceSelector]', 'Launch a Hosanna app on a platform target, including car and watch surfaces', yargs => yargs
     .parserConfiguration({ 'boolean-negation': false, 'populate--': true })
     .positional('platform', {
     type: 'string',
@@ -1929,7 +1958,7 @@ catch (err) {
 })
     .option('platform', {
     type: 'string',
-    choices: ['web', 'roku', 'ios', 'apple-tv', 'android', 'android-tv'],
+    choices: RUN_PLATFORM_CHOICES,
     describe: 'Launch platform.',
 })
     .option('env', {
@@ -2003,6 +2032,10 @@ catch (err) {
     .example('$0 run --platform android --target device --device "RF8M62694QT" --no-logs', 'Build, install, and launch on a physical Android device')
     .example('$0 run --platform android-tv --target sim --device "Television_1080p" --no-logs', 'Build, install, and launch on an Android TV emulator')
     .example('$0 run --platform apple-tv --target sim --device "Apple TV 4K"', 'Build, install, and launch on an Apple TV simulator')
+    .example('$0 run --platform carplay --target sim --device "iPhone 17 Pro"', 'Launch the iPhone host and open the CarPlay Simulator display')
+    .example('$0 run --platform android-auto --target sim --device "Pixel_8"', 'Launch Android Auto through the Desktop Head Unit')
+    .example('$0 run --platform apple-watch --target sim --device "Apple Watch Series 11 (46mm)"', 'Build and launch through the paired Apple Watch simulator')
+    .example('$0 run --platform wear-os --target sim --device "Wear_OS_Large_Round"', 'Build, install, and launch on a Wear OS emulator')
     .example('$0 run --platform roku --target device --device "living room"', 'Build, deploy, launch, and stream logs on a Roku device')
     .example('$0 run roku dev device --app criterion', 'Run a configured monorepo app/flavor')
     .example('$0 run roku prod device --hsc-project platforms/hsconfig.criterion.prod.json', 'Override the Roku HSC project file'), async (args) => {