@tantawowa/hosanna-tools 3.32.0 → 4.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +38 -100
- package/dist/artwork/app-artwork.d.ts +2 -59
- package/dist/artwork/app-artwork.js +26 -243
- package/dist/artwork/app-artwork.js.map +1 -1
- package/dist/build-info.json +3 -3
- package/dist/capture/mcp-tools.d.ts +1 -1
- package/dist/capture/mcp-tools.js +2 -4
- package/dist/capture/mcp-tools.js.map +1 -1
- package/dist/capture/video-capture.d.ts +2 -13
- package/dist/capture/video-capture.js +8 -53
- package/dist/capture/video-capture.js.map +1 -1
- package/dist/cli.js +44 -338
- package/dist/cli.js.map +1 -1
- package/dist/device/device-cli.js +4 -19
- package/dist/device/device-cli.js.map +1 -1
- package/dist/device/devices-file.js +4 -7
- package/dist/device/devices-file.js.map +1 -1
- package/dist/device/driver-registry.js +3 -31
- package/dist/device/driver-registry.js.map +1 -1
- package/dist/device/types.d.ts +1 -1
- package/dist/generation/shapes/shape-compiler.js +9 -0
- package/dist/generation/shapes/shape-compiler.js.map +1 -1
- package/dist/index.d.ts +3 -16
- package/dist/index.js +1 -22
- package/dist/index.js.map +1 -1
- package/dist/lib/app-config-resolver.js +10 -19
- package/dist/lib/app-config-resolver.js.map +1 -1
- package/dist/run/destination-picker.js +5 -60
- package/dist/run/destination-picker.js.map +1 -1
- package/dist/run/executor.d.ts +0 -9
- package/dist/run/executor.js +50 -119
- package/dist/run/executor.js.map +1 -1
- package/dist/run/launch-installed.d.ts +5 -14
- package/dist/run/launch-installed.js +17 -58
- package/dist/run/launch-installed.js.map +1 -1
- package/dist/run/planner.d.ts +2 -10
- package/dist/run/planner.js +26 -778
- package/dist/run/planner.js.map +1 -1
- package/dist/run/run-config.d.ts +5 -12
- package/dist/run/run-config.js +8 -36
- package/dist/run/run-config.js.map +1 -1
- package/dist/run/run-controller.d.ts +1 -43
- package/dist/run/run-controller.js +14 -1572
- package/dist/run/run-controller.js.map +1 -1
- package/dist/run/targets.d.ts +1 -65
- package/dist/run/targets.js +13 -282
- package/dist/run/targets.js.map +1 -1
- package/dist/run/types.d.ts +8 -13
- package/dist/run/types.js +14 -19
- package/dist/run/types.js.map +1 -1
- package/dist/run/web-build.d.ts +1 -0
- package/dist/run/web-build.js +15 -0
- package/dist/run/web-build.js.map +1 -1
- package/dist/support-tools/build-config-resolver.js +7 -77
- package/dist/support-tools/build-config-resolver.js.map +1 -1
- package/dist/support-tools/dev-runner.js +2 -2
- package/dist/support-tools/dev-runner.js.map +1 -1
- package/dist/support-tools/mcp-server/tools.js +2 -2
- package/dist/support-tools/mcp-server/tools.js.map +1 -1
- package/dist/testing/client.js +1 -35
- package/dist/testing/client.js.map +1 -1
- package/dist/testing/launch-args.d.ts +11 -0
- package/dist/testing/launch-args.js +8 -0
- package/dist/testing/launch-args.js.map +1 -0
- package/dist/testing/launcher.d.ts +1 -1
- package/dist/testing/launcher.js +44 -153
- package/dist/testing/launcher.js.map +1 -1
- package/dist/testing/physical-tv.d.ts +0 -11
- package/dist/testing/physical-tv.js +0 -49
- package/dist/testing/physical-tv.js.map +1 -1
- package/dist/testing/stream-config.d.ts +7 -0
- package/dist/testing/stream-config.js +31 -0
- package/dist/testing/stream-config.js.map +1 -0
- package/dist/testing/target.js +6 -3
- package/dist/testing/target.js.map +1 -1
- package/dist/testing/types.d.ts +5 -10
- package/dist/updater/framework-installer.d.ts +0 -1
- package/dist/updater/framework-installer.js +0 -13
- package/dist/updater/framework-installer.js.map +1 -1
- package/dist/updater/license-manager.d.ts +1 -2
- package/dist/updater/license-manager.js +1 -14
- package/dist/updater/license-manager.js.map +1 -1
- package/dist/updater/sdk-manager.d.ts +1 -1
- package/dist/updater/sdk-manager.js +1 -1
- package/dist/vite-app-artwork.js +1 -6
- package/dist/vite-app-artwork.js.map +1 -1
- package/dist/vite-pwa.d.ts +0 -3
- package/dist/vite-pwa.js +0 -9
- package/dist/vite-pwa.js.map +1 -1
- package/package.json +2 -8
- package/dist/artwork/native-artwork.d.ts +0 -33
- package/dist/artwork/native-artwork.js +0 -297
- package/dist/artwork/native-artwork.js.map +0 -1
- package/dist/artwork/packaged-artwork.d.ts +0 -10
- package/dist/artwork/packaged-artwork.js +0 -465
- package/dist/artwork/packaged-artwork.js.map +0 -1
- package/dist/device/drivers/tizen-driver.d.ts +0 -19
- package/dist/device/drivers/tizen-driver.js +0 -178
- package/dist/device/drivers/tizen-driver.js.map +0 -1
- package/dist/device/drivers/webos-driver.d.ts +0 -15
- package/dist/device/drivers/webos-driver.js +0 -175
- package/dist/device/drivers/webos-driver.js.map +0 -1
- package/dist/device/setup.d.ts +0 -39
- package/dist/device/setup.js +0 -168
- package/dist/device/setup.js.map +0 -1
- package/dist/native/app-entry-generation.d.ts +0 -9
- package/dist/native/app-entry-generation.js +0 -100
- package/dist/native/app-entry-generation.js.map +0 -1
- package/dist/native/artifacts.d.ts +0 -104
- package/dist/native/artifacts.js +0 -747
- package/dist/native/artifacts.js.map +0 -1
- package/dist/native/native-project.d.ts +0 -108
- package/dist/native/native-project.js +0 -1590
- package/dist/native/native-project.js.map +0 -1
- package/dist/native/prepared-runtime.d.ts +0 -14
- package/dist/native/prepared-runtime.js +0 -20
- package/dist/native/prepared-runtime.js.map +0 -1
- package/dist/native/templates/android/AndroidAutoManifest.xml +0 -33
- package/dist/native/templates/android/AndroidManifest.xml +0 -20
- package/dist/native/templates/android/WearOsManifest.xml +0 -31
- package/dist/native/templates/android/app-build.gradle.kts +0 -300
- package/dist/native/templates/android/automotive_app_desc.xml +0 -5
- package/dist/native/templates/android/build.gradle.kts +0 -5
- package/dist/native/templates/android/car_attribution_icon.xml +0 -10
- package/dist/native/templates/android/colors.xml +0 -3
- package/dist/native/templates/android/gradle-wrapper.jar +0 -0
- package/dist/native/templates/android/gradle-wrapper.properties +0 -7
- package/dist/native/templates/android/gradle.properties +0 -3
- package/dist/native/templates/android/gradlew +0 -251
- package/dist/native/templates/android/gradlew.bat +0 -94
- package/dist/native/templates/android/hosanna-animated-image-proguard-rules.pro +0 -5
- package/dist/native/templates/android/launcher.xml +0 -12
- package/dist/native/templates/android/settings.gradle.kts +0 -18
- package/dist/native/templates/android/strings.xml +0 -3
- package/dist/native/templates/android/styles.xml +0 -8
- package/dist/native/templates/apple/AppIconContents.json +0 -7
- package/dist/native/templates/apple/HosannaCarPlay.entitlements +0 -8
- package/dist/native/templates/apple/HosannaIosApp.swift +0 -110
- package/dist/native/templates/apple/HosannaTvApp.swift +0 -118
- package/dist/native/templates/apple/HosannaWatchApp.swift +0 -10
- package/dist/native/templates/apple/Info.carplay.plist +0 -43
- package/dist/native/templates/apple/Info.plist +0 -24
- package/dist/native/templates/apple/Info.watchos.plist +0 -26
- package/dist/native/templates/apple/Podfile.example +0 -7
- package/dist/native/templates/apple/project.yml +0 -107
- package/dist/native/templates/artifacts/verify-aab.mjs +0 -11
- package/dist/run/android-auto.d.ts +0 -11
- package/dist/run/android-auto.js +0 -121
- package/dist/run/android-auto.js.map +0 -1
- package/dist/run/android-emulator.d.ts +0 -80
- package/dist/run/android-emulator.js +0 -1208
- package/dist/run/android-emulator.js.map +0 -1
- package/dist/run/apple-tv.d.ts +0 -35
- package/dist/run/apple-tv.js +0 -410
- package/dist/run/apple-tv.js.map +0 -1
- package/dist/run/apple-watch.d.ts +0 -49
- package/dist/run/apple-watch.js +0 -389
- package/dist/run/apple-watch.js.map +0 -1
- package/dist/run/carplay.d.ts +0 -17
- package/dist/run/carplay.js +0 -232
- package/dist/run/carplay.js.map +0 -1
- package/dist/run/code-bundle-descriptor.d.ts +0 -31
- package/dist/run/code-bundle-descriptor.js +0 -68
- package/dist/run/code-bundle-descriptor.js.map +0 -1
- package/dist/run/installed-native-launch.d.ts +0 -12
- package/dist/run/installed-native-launch.js +0 -46
- package/dist/run/installed-native-launch.js.map +0 -1
- package/dist/run/ios-device.d.ts +0 -21
- package/dist/run/ios-device.js +0 -254
- package/dist/run/ios-device.js.map +0 -1
- package/dist/run/ios-simulator.d.ts +0 -23
- package/dist/run/ios-simulator.js +0 -217
- package/dist/run/ios-simulator.js.map +0 -1
- package/dist/run/native-build.d.ts +0 -21
- package/dist/run/native-build.js +0 -178
- package/dist/run/native-build.js.map +0 -1
- package/dist/run/tv-build.d.ts +0 -56
- package/dist/run/tv-build.js +0 -670
- package/dist/run/tv-build.js.map +0 -1
- package/dist/run/tv-test-config.d.ts +0 -13
- package/dist/run/tv-test-config.js +0 -70
- package/dist/run/tv-test-config.js.map +0 -1
- package/dist/support-tools/android-dev-server.d.ts +0 -2
- package/dist/support-tools/android-dev-server.js +0 -124
- package/dist/support-tools/android-dev-server.js.map +0 -1
- package/dist/support-tools/android-log-transformer.d.ts +0 -10
- package/dist/support-tools/android-log-transformer.js +0 -77
- package/dist/support-tools/android-log-transformer.js.map +0 -1
- package/dist/support-tools/android-metro-build.d.ts +0 -15
- package/dist/support-tools/android-metro-build.js +0 -373
- package/dist/support-tools/android-metro-build.js.map +0 -1
- package/dist/support-tools/apple-bundler.d.ts +0 -9
- package/dist/support-tools/apple-bundler.js +0 -426
- package/dist/support-tools/apple-bundler.js.map +0 -1
- package/dist/testing/native-simulator.d.ts +0 -42
- package/dist/testing/native-simulator.js +0 -222
- package/dist/testing/native-simulator.js.map +0 -1
package/dist/cli.js
CHANGED
|
@@ -110,8 +110,6 @@ function runPlanFlagsFromCliArgs(args, format) {
|
|
|
110
110
|
device: rawHasFlag('device') ? args.device : undefined,
|
|
111
111
|
profile: rawHasFlag('profile') ? args.profile : undefined,
|
|
112
112
|
appConfig: rawHasFlag('app-config') ? args['app-config'] : undefined,
|
|
113
|
-
hotReload: rawHasFlag('hot-reload') ? Boolean(args['hot-reload']) : undefined,
|
|
114
|
-
bundled: rawHasFlag('bundled') ? Boolean(args.bundled) : undefined,
|
|
115
113
|
noBuild: rawHasFlag('no-build') ? Boolean(args['no-build']) : undefined,
|
|
116
114
|
buildOnly: rawHasFlag('build-only') ? Boolean(args['build-only']) : undefined,
|
|
117
115
|
noLogs: rawHasFlag('no-logs') ? Boolean(args['no-logs']) : undefined,
|
|
@@ -142,9 +140,7 @@ function runPlanFlagsFromCliArgs(args, format) {
|
|
|
142
140
|
rebuildAppConfig: rawHasFlag('rebuild-app-config') ? Boolean(args['rebuild-app-config']) : undefined,
|
|
143
141
|
buildCmd: rawHasFlag('build-cmd') ? args['build-cmd'] : undefined,
|
|
144
142
|
viteConfig: rawHasFlag('vite-config') ? args['vite-config'] : undefined,
|
|
145
|
-
signingProfile: rawHasFlag('signing-profile') ? args['signing-profile'] : undefined,
|
|
146
143
|
appId: rawHasFlag('app-id') ? args['app-id'] : undefined,
|
|
147
|
-
connectOrigins: rawHasFlag('connect-origin') ? args['connect-origin'] : undefined,
|
|
148
144
|
passthroughArgs: args['--'],
|
|
149
145
|
};
|
|
150
146
|
}
|
|
@@ -243,47 +239,7 @@ function rememberedExplicitDestination(plan, hasExplicitDestination) {
|
|
|
243
239
|
return undefined;
|
|
244
240
|
return Object.assign({ platform: plan.resolved.platform, target }, (plan.resolved.deviceSelector ? { device: plan.resolved.deviceSelector } : {}));
|
|
245
241
|
}
|
|
246
|
-
const
|
|
247
|
-
'apple', 'ios', 'apple-tv', 'carplay', 'apple-watch', 'watchos',
|
|
248
|
-
'android', 'android-tv', 'android-auto', 'wear-os', 'wearos', 'android-watch',
|
|
249
|
-
'cars', 'watches', 'all',
|
|
250
|
-
];
|
|
251
|
-
const RUN_PLATFORM_CHOICES = [
|
|
252
|
-
'browser', 'web', 'tizen', 'webos', 'roku', 'ios', 'apple-tv', 'carplay', 'apple-watch', 'watchos',
|
|
253
|
-
'android', 'android-tv', 'android-auto', 'wear-os', 'wearos', 'android-watch',
|
|
254
|
-
];
|
|
255
|
-
function nativeInputFromArgs(args) {
|
|
256
|
-
return {
|
|
257
|
-
cwd: process.cwd(),
|
|
258
|
-
platform: nativePlatformArg(args.platform),
|
|
259
|
-
app: stringArg(args.app),
|
|
260
|
-
displayName: stringArg(args['display-name']),
|
|
261
|
-
bundleId: stringArg(args['bundle-id']),
|
|
262
|
-
iosBundleId: stringArg(args['ios-bundle-id']),
|
|
263
|
-
appleTvBundleId: stringArg(args['apple-tv-bundle-id']),
|
|
264
|
-
appleWatchBundleId: stringArg(args['apple-watch-bundle-id']),
|
|
265
|
-
androidPackage: stringArg(args['android-package']),
|
|
266
|
-
androidTvPackage: stringArg(args['android-tv-package']),
|
|
267
|
-
androidAutoPackage: stringArg(args['android-auto-package']),
|
|
268
|
-
androidAutoMediaBrowserService: stringArg(args['android-auto-media-browser-service']),
|
|
269
|
-
wearOsPackage: stringArg(args['wear-os-package']),
|
|
270
|
-
teamId: stringArg(args['team-id']),
|
|
271
|
-
versionName: stringArg(args['version-name']),
|
|
272
|
-
versionCode: numberOrStringArg(args['version-code']),
|
|
273
|
-
referenceRoot: stringArg(args['reference-root']),
|
|
274
|
-
replace: Boolean(args.replace),
|
|
275
|
-
dryRun: Boolean(args['dry-run']),
|
|
276
|
-
nonInteractive: Boolean(args['non-interactive']),
|
|
277
|
-
};
|
|
278
|
-
}
|
|
279
|
-
function nativePlatformArg(value) {
|
|
280
|
-
return typeof value === 'string' && value.trim()
|
|
281
|
-
? value.trim()
|
|
282
|
-
: undefined;
|
|
283
|
-
}
|
|
284
|
-
function nativeFormatArg(args) {
|
|
285
|
-
return args.format === 'json' ? 'json' : 'text';
|
|
286
|
-
}
|
|
242
|
+
const RUN_PLATFORM_CHOICES = ['browser', 'web', 'roku'];
|
|
287
243
|
function stringArg(value) {
|
|
288
244
|
return typeof value === 'string' && value.trim() ? value.trim() : undefined;
|
|
289
245
|
}
|
|
@@ -314,7 +270,7 @@ async function runVideoCaptureCommand(args) {
|
|
|
314
270
|
try {
|
|
315
271
|
const platform = ((_a = args.platform) !== null && _a !== void 0 ? _a : args.platformArg);
|
|
316
272
|
if (!platform)
|
|
317
|
-
throw new Error('Capture platform is required. Use
|
|
273
|
+
throw new Error('Capture platform is required. Use roku or web.');
|
|
318
274
|
const mod = await Promise.resolve().then(() => __importStar(require('./capture/video-capture.js')));
|
|
319
275
|
const session = await mod.startVideoCapture({
|
|
320
276
|
platform,
|
|
@@ -322,8 +278,6 @@ async function runVideoCaptureCommand(args) {
|
|
|
322
278
|
cwd: process.cwd(),
|
|
323
279
|
outputPath: stringArg(args.output),
|
|
324
280
|
timeoutSeconds: args['timeout-seconds'],
|
|
325
|
-
device: stringArg(args.device),
|
|
326
|
-
codec: args.codec,
|
|
327
281
|
videoDevice: stringArg(args['video-device']),
|
|
328
282
|
audioDevice: stringArg(args['audio-device']),
|
|
329
283
|
frameRate: args['frame-rate'],
|
|
@@ -372,11 +326,6 @@ async function runVideoCaptureCommand(args) {
|
|
|
372
326
|
process.exitCode = 1;
|
|
373
327
|
}
|
|
374
328
|
}
|
|
375
|
-
function numberOrStringArg(value) {
|
|
376
|
-
if (typeof value === 'number' && Number.isFinite(value))
|
|
377
|
-
return value;
|
|
378
|
-
return stringArg(value);
|
|
379
|
-
}
|
|
380
329
|
// Read build date, version, and git hash embedded at build time
|
|
381
330
|
let buildDate = 'unknown';
|
|
382
331
|
let buildVersion = 'unknown';
|
|
@@ -442,27 +391,27 @@ async function runEnvironmentCommand(action, verbose) {
|
|
|
442
391
|
// Let yargs handle all commands including env
|
|
443
392
|
(0, yargs_1.default)((0, helpers_1.hideBin)(process.argv))
|
|
444
393
|
.version(`${buildVersion}\n git: ${buildGitHash}\n built: ${buildDate}`)
|
|
445
|
-
.usage(
|
|
394
|
+
.usage(`Hosanna Tools CLI\nVersion: ${buildVersion}\nBuild Date: ${buildDate}\n\nCommand Groups:\n compiler:* Compiler lifecycle (install, status, list)\n config hosanna.json management (wizard, show, set)\n doctor Friendly environment/package check (use --fix to repair)\n env Environment checks and repair (check, fix, prepare-gitignore)\n dev:* Local development execution\n debugger:* Command debugger control\n mcp:* Hosanna MCP server control\n build Roku and Roku browser emulator builds\n run Roku and Roku browser emulator launches\n capture Standalone scenario video capture\n target:* Run target discovery and inventory\n roku:* Roku deployment, commands & packaging (run, command, package, map-stack)\n device:* Device discovery and run workflows\n generate:* Code and asset generation\n sdk:* Hosanna SDK/framework installation\n build-config:* Build/runtime configuration resolution\n ci:* Continuous integration helpers\n framework:* Framework distribution helpers\n license:* Hosanna framework licensing\n secrets:* Portable .secrets files\n rasp:* RASP cert scripts`)
|
|
446
395
|
.option('verbose', {
|
|
447
396
|
type: 'boolean',
|
|
448
397
|
default: false,
|
|
449
398
|
describe: 'Enable verbose logging for all operations',
|
|
450
399
|
global: true
|
|
451
400
|
})
|
|
452
|
-
.command('capture [platformArg]', 'Record
|
|
401
|
+
.command('capture [platformArg]', 'Record Roku through a capture card or its web simulator through a host screen/window', yargs => yargs
|
|
453
402
|
.positional('platformArg', {
|
|
454
403
|
type: 'string',
|
|
455
|
-
choices: ['
|
|
404
|
+
choices: ['roku', 'web'],
|
|
456
405
|
describe: 'Platform being recorded',
|
|
457
406
|
})
|
|
458
407
|
.option('platform', {
|
|
459
408
|
type: 'string',
|
|
460
|
-
choices: ['
|
|
409
|
+
choices: ['roku', 'web'],
|
|
461
410
|
describe: 'Platform being recorded (alternative to the positional argument)',
|
|
462
411
|
})
|
|
463
412
|
.option('source', {
|
|
464
413
|
type: 'string',
|
|
465
|
-
choices: ['
|
|
414
|
+
choices: ['avfoundation', 'macos-screen', 'macos-window'],
|
|
466
415
|
describe: 'Capture source; defaults from platform and window/screen options',
|
|
467
416
|
})
|
|
468
417
|
.option('output', { alias: 'o', type: 'string', describe: 'Output video path (default: recordings/<platform>-<timestamp>.<ext>)' })
|
|
@@ -472,8 +421,6 @@ async function runEnvironmentCommand(action, verbose) {
|
|
|
472
421
|
default: 180,
|
|
473
422
|
describe: 'Automatically stop and finalize after this many seconds',
|
|
474
423
|
})
|
|
475
|
-
.option('device', { type: 'string', describe: 'Booted Apple simulator name or UDID' })
|
|
476
|
-
.option('codec', { type: 'string', choices: ['h264', 'hevc'], default: 'h264', describe: 'Apple simulator codec' })
|
|
477
424
|
.option('video-device', { type: 'string', describe: 'AVFoundation video device name or index' })
|
|
478
425
|
.option('audio-device', { type: 'string', describe: 'Optional AVFoundation audio device name or index' })
|
|
479
426
|
.option('frame-rate', { type: 'number', default: 30, describe: 'AVFoundation capture frame rate' })
|
|
@@ -486,7 +433,6 @@ async function runEnvironmentCommand(action, verbose) {
|
|
|
486
433
|
.option('show-cursor', { type: 'boolean', default: false, describe: 'Include the pointer in macOS capture' })
|
|
487
434
|
.option('show-clicks', { type: 'boolean', default: false, describe: 'Show clicks in macOS capture' })
|
|
488
435
|
.option('format', { type: 'string', choices: ['text', 'json'], default: 'text', describe: 'Completion output format' })
|
|
489
|
-
.example('$0 capture ios --device "iPhone 17 Pro"', 'Record the booted iOS simulator for up to 180 seconds')
|
|
490
436
|
.example('$0 capture roku --video-device "USB Video" --audio-device "USB Digital Audio" --timeout 300', 'Record a Roku capture card for five minutes')
|
|
491
437
|
.example('$0 capture roku --source macos-window --application "QuickTime Player"', 'Record a QuickTime capture window'), async (args) => runVideoCaptureCommand(args))
|
|
492
438
|
.command('game:prep-level <input>', 'Normalize a Tiled JSON map into the Hs2d canonical runtime subset', yargs => yargs
|
|
@@ -525,7 +471,7 @@ async function runEnvironmentCommand(action, verbose) {
|
|
|
525
471
|
})
|
|
526
472
|
.command('build-config:resolve', 'Resolve Hosanna build config overlays into the canonical runtime build-config.json', yargs => yargs
|
|
527
473
|
.option('env', { type: 'string', describe: 'Environment, e.g. dev, qa, or prod (or HS_ENV / HOSANNA_BUILD_ENV)' })
|
|
528
|
-
.option('platform', { type: 'string', describe: 'Platform
|
|
474
|
+
.option('platform', { type: 'string', describe: 'Platform: roku or web (or HS_PLATFORM / HOSANNA_BUILD_PLATFORM)' })
|
|
529
475
|
.option('profile', { type: 'string', describe: 'Optional explicit local developer profile (or HS_BUILD_PROFILE)' })
|
|
530
476
|
.option('format', { type: 'string', choices: ['json'], describe: 'Print resolved config to stdout as JSON' })
|
|
531
477
|
.option('out', { type: 'string', describe: 'Write resolved config to this file' })
|
|
@@ -613,10 +559,10 @@ async function runEnvironmentCommand(action, verbose) {
|
|
|
613
559
|
process.exit(0);
|
|
614
560
|
})
|
|
615
561
|
.command('app-config:resolve', 'Resolve a Hosanna app config file, including root-level $extendFile inheritance', yargs => yargs
|
|
616
|
-
.option('input', { type: 'string', describe: 'Input path, app.config.<name>.json filename, or short selector such as
|
|
562
|
+
.option('input', { type: 'string', describe: 'Input path, app.config.<name>.json filename, or short selector such as tv' })
|
|
617
563
|
.option('cwd', { type: 'string', describe: 'Project root (default: current working directory)' })
|
|
618
|
-
.option('expression', { type: 'string', describe: 'Expression selector used when --input is omitted, such as tv
|
|
619
|
-
.option('platform', { type: 'string', describe: 'Platform selector used when --input is omitted,
|
|
564
|
+
.option('expression', { type: 'string', describe: 'Expression selector used when --input is omitted, such as tv' })
|
|
565
|
+
.option('platform', { type: 'string', describe: 'Platform selector used when --input is omitted, roku or web' })
|
|
620
566
|
.option('out', { type: 'string', describe: 'Write resolved JSON to this file instead of stdout' }), args => {
|
|
621
567
|
try {
|
|
622
568
|
(0, cli_app_config_resolve_js_1.runAppConfigResolveCommand)({
|
|
@@ -637,7 +583,7 @@ async function runEnvironmentCommand(action, verbose) {
|
|
|
637
583
|
.command('app-config:compile', 'Resolve AppConfig and materialize precompiled theme shapes, bundled fonts, and static asset bundles', yargs => yargs
|
|
638
584
|
.option('input', { type: 'string', describe: 'Input path, app.config.<name>.json filename, or short selector' })
|
|
639
585
|
.option('cwd', { type: 'string', describe: 'Project root (default: current working directory)' })
|
|
640
|
-
.option('expression', { type: 'string', describe: 'Expression selector such as tv
|
|
586
|
+
.option('expression', { type: 'string', describe: 'Expression selector such as tv' })
|
|
641
587
|
.option('platform', { type: 'string', default: 'roku', describe: 'Compilation platform' })
|
|
642
588
|
.option('out', { type: 'string', describe: 'Final resolved AppConfig output path' })
|
|
643
589
|
.option('generated-dir', { type: 'string', describe: 'Generated target root (contains package/)' })
|
|
@@ -686,7 +632,7 @@ async function runEnvironmentCommand(action, verbose) {
|
|
|
686
632
|
.command('app-config:clean', 'Remove compiler-owned AppConfig package, asset bundle, and incremental caches for one target', yargs => yargs
|
|
687
633
|
.option('input', { type: 'string', describe: 'Input path, app.config.<name>.json filename, or short selector used to infer the target' })
|
|
688
634
|
.option('cwd', { type: 'string', describe: 'Project root (default: current working directory)' })
|
|
689
|
-
.option('expression', { type: 'string', describe: 'Expression selector such as tv
|
|
635
|
+
.option('expression', { type: 'string', describe: 'Expression selector such as tv' })
|
|
690
636
|
.option('platform', { type: 'string', default: 'roku', describe: 'Compilation platform' })
|
|
691
637
|
.option('generated-dir', { type: 'string', describe: 'Generated target root (contains package/)' })
|
|
692
638
|
.option('bundle-id', { type: 'string', describe: 'Asset bundle id to remove' })
|
|
@@ -710,125 +656,6 @@ async function runEnvironmentCommand(action, verbose) {
|
|
|
710
656
|
console.error(`Failed to clean app config: ${message}`);
|
|
711
657
|
process.exit(1);
|
|
712
658
|
}
|
|
713
|
-
})
|
|
714
|
-
.command('native:init [platform]', 'Initialize app-owned Hosanna native thin projects and config', yargs => yargs
|
|
715
|
-
.positional('platform', { type: 'string', choices: NATIVE_PLATFORM_CHOICES, default: 'all', describe: 'Native platform family to initialize' })
|
|
716
|
-
.option('app', { type: 'string', describe: 'App key/name used when inferring defaults' })
|
|
717
|
-
.option('display-name', { type: 'string', describe: 'Native display name' })
|
|
718
|
-
.option('bundle-id', { type: 'string', describe: 'Base bundle/package identifier' })
|
|
719
|
-
.option('ios-bundle-id', { type: 'string', describe: 'iOS bundle identifier' })
|
|
720
|
-
.option('apple-tv-bundle-id', { type: 'string', describe: 'tvOS bundle identifier' })
|
|
721
|
-
.option('apple-watch-bundle-id', { type: 'string', describe: 'watchOS bundle identifier' })
|
|
722
|
-
.option('android-package', { type: 'string', describe: 'Android namespace and phone package base' })
|
|
723
|
-
.option('android-tv-package', { type: 'string', describe: 'Android TV application id' })
|
|
724
|
-
.option('android-auto-package', { type: 'string', describe: 'Android Auto application id' })
|
|
725
|
-
.option('android-auto-media-browser-service', { type: 'string', describe: 'App-owned Android Auto MediaBrowserService or MediaLibraryService class' })
|
|
726
|
-
.option('wear-os-package', { type: 'string', describe: 'Wear OS application id' })
|
|
727
|
-
.option('team-id', { type: 'string', describe: 'Apple development team id for generated xcconfig files' })
|
|
728
|
-
.option('version-name', { type: 'string', describe: 'Native marketing/versionName value' })
|
|
729
|
-
.option('version-code', { type: 'number', describe: 'Native build/versionCode value' })
|
|
730
|
-
.option('reference-root', { type: 'string', default: 'hosanna-ui', describe: 'Installed framework/runtime root inside the app repo' })
|
|
731
|
-
.option('replace', { type: 'boolean', default: false, describe: 'Replace unchanged hst-managed native template files' })
|
|
732
|
-
.option('dry-run', { type: 'boolean', default: false, describe: 'Print the native init plan without writing files' })
|
|
733
|
-
.option('format', { type: 'string', choices: ['text', 'json'], default: 'text', describe: 'Output format' })
|
|
734
|
-
.option('non-interactive', { type: 'boolean', default: false, describe: 'Fail instead of prompting when a decision is needed' })
|
|
735
|
-
.example('$0 native:init all --display-name "Hope Stream"', 'Initialize Apple and Android app-owned native projects')
|
|
736
|
-
.example('$0 native:init watches --display-name "Hope Stream"', 'Initialize Apple Watch and Wear OS native targets')
|
|
737
|
-
.example('$0 native:init android-tv --dry-run --format json', 'Preview Android TV native setup as JSON'), async (args) => {
|
|
738
|
-
try {
|
|
739
|
-
const mod = await Promise.resolve().then(() => __importStar(require('./native/native-project.js')));
|
|
740
|
-
const input = nativeInputFromArgs(args);
|
|
741
|
-
const format = nativeFormatArg(args);
|
|
742
|
-
const plan = mod.createNativeInitPlan(input);
|
|
743
|
-
if (input.dryRun) {
|
|
744
|
-
console.info(format === 'json' ? JSON.stringify(plan, null, 2) : mod.formatNativeInitPlanText(plan));
|
|
745
|
-
process.exit(plan.errors.length > 0 ? 1 : 0);
|
|
746
|
-
}
|
|
747
|
-
const result = await mod.executeNativeInitPlan(plan);
|
|
748
|
-
if (format === 'json') {
|
|
749
|
-
console.info(JSON.stringify(result, null, 2));
|
|
750
|
-
}
|
|
751
|
-
else {
|
|
752
|
-
console.info(`hst native:init applied for ${plan.requestedPlatforms.join(', ')}`);
|
|
753
|
-
console.info(mod.formatNativeInitPlanText(plan));
|
|
754
|
-
}
|
|
755
|
-
process.exit(0);
|
|
756
|
-
}
|
|
757
|
-
catch (err) {
|
|
758
|
-
console.error('❌ native:init failed');
|
|
759
|
-
console.error(err instanceof Error ? err.message : String(err));
|
|
760
|
-
process.exit(1);
|
|
761
|
-
}
|
|
762
|
-
})
|
|
763
|
-
.command('native:doctor [platform]', 'Validate Hosanna native platform setup and print actionable fixes', yargs => yargs
|
|
764
|
-
.positional('platform', { type: 'string', choices: NATIVE_PLATFORM_CHOICES, default: 'all', describe: 'Native platform family to validate' })
|
|
765
|
-
.option('app', { type: 'string', describe: 'App key/name used when inferring defaults' })
|
|
766
|
-
.option('display-name', { type: 'string', describe: 'Native display name' })
|
|
767
|
-
.option('bundle-id', { type: 'string', describe: 'Base bundle/package identifier' })
|
|
768
|
-
.option('ios-bundle-id', { type: 'string', describe: 'iOS bundle identifier' })
|
|
769
|
-
.option('apple-tv-bundle-id', { type: 'string', describe: 'tvOS bundle identifier' })
|
|
770
|
-
.option('apple-watch-bundle-id', { type: 'string', describe: 'watchOS bundle identifier' })
|
|
771
|
-
.option('android-package', { type: 'string', describe: 'Android namespace and phone package base' })
|
|
772
|
-
.option('android-tv-package', { type: 'string', describe: 'Android TV application id' })
|
|
773
|
-
.option('android-auto-package', { type: 'string', describe: 'Android Auto application id' })
|
|
774
|
-
.option('android-auto-media-browser-service', { type: 'string', describe: 'App-owned Android Auto MediaBrowserService or MediaLibraryService class' })
|
|
775
|
-
.option('wear-os-package', { type: 'string', describe: 'Wear OS application id' })
|
|
776
|
-
.option('team-id', { type: 'string', describe: 'Apple development team id for generated xcconfig files' })
|
|
777
|
-
.option('version-name', { type: 'string', describe: 'Native marketing/versionName value' })
|
|
778
|
-
.option('version-code', { type: 'number', describe: 'Native build/versionCode value' })
|
|
779
|
-
.option('reference-root', { type: 'string', default: 'hosanna-ui', describe: 'Installed framework/runtime root inside the app repo' })
|
|
780
|
-
.option('replace', { type: 'boolean', default: false, describe: 'Plan replacement checks for unchanged hst-managed native files' })
|
|
781
|
-
.option('dry-run', { type: 'boolean', default: false, describe: 'Accepted for script parity; doctor never writes files' })
|
|
782
|
-
.option('format', { type: 'string', choices: ['text', 'json'], default: 'text', describe: 'Output format' })
|
|
783
|
-
.option('non-interactive', { type: 'boolean', default: false, describe: 'Fail instead of prompting when a decision is needed' })
|
|
784
|
-
.example('$0 native:doctor all --format json', 'Validate native setup as JSON'), async (args) => {
|
|
785
|
-
try {
|
|
786
|
-
const mod = await Promise.resolve().then(() => __importStar(require('./native/native-project.js')));
|
|
787
|
-
const report = mod.createNativeDoctorReport(nativeInputFromArgs(args));
|
|
788
|
-
const format = nativeFormatArg(args);
|
|
789
|
-
console.info(format === 'json' ? JSON.stringify(report, null, 2) : mod.formatNativeDoctorReportText(report));
|
|
790
|
-
process.exit(0);
|
|
791
|
-
}
|
|
792
|
-
catch (err) {
|
|
793
|
-
console.error('❌ native:doctor failed');
|
|
794
|
-
console.error(err instanceof Error ? err.message : String(err));
|
|
795
|
-
process.exit(1);
|
|
796
|
-
}
|
|
797
|
-
})
|
|
798
|
-
.command('native:prepare [platform]', 'Run lightweight Hosanna native prebuild validation', yargs => yargs
|
|
799
|
-
.positional('platform', { type: 'string', choices: NATIVE_PLATFORM_CHOICES, default: 'all', describe: 'Native platform family to prepare' })
|
|
800
|
-
.option('app', { type: 'string', describe: 'App key/name used when inferring defaults' })
|
|
801
|
-
.option('display-name', { type: 'string', describe: 'Native display name' })
|
|
802
|
-
.option('bundle-id', { type: 'string', describe: 'Base bundle/package identifier' })
|
|
803
|
-
.option('ios-bundle-id', { type: 'string', describe: 'iOS bundle identifier' })
|
|
804
|
-
.option('apple-tv-bundle-id', { type: 'string', describe: 'tvOS bundle identifier' })
|
|
805
|
-
.option('apple-watch-bundle-id', { type: 'string', describe: 'watchOS bundle identifier' })
|
|
806
|
-
.option('android-package', { type: 'string', describe: 'Android namespace and phone package base' })
|
|
807
|
-
.option('android-tv-package', { type: 'string', describe: 'Android TV application id' })
|
|
808
|
-
.option('android-auto-package', { type: 'string', describe: 'Android Auto application id' })
|
|
809
|
-
.option('android-auto-media-browser-service', { type: 'string', describe: 'App-owned Android Auto MediaBrowserService or MediaLibraryService class' })
|
|
810
|
-
.option('wear-os-package', { type: 'string', describe: 'Wear OS application id' })
|
|
811
|
-
.option('team-id', { type: 'string', describe: 'Apple development team id for generated xcconfig files' })
|
|
812
|
-
.option('version-name', { type: 'string', describe: 'Native marketing/versionName value' })
|
|
813
|
-
.option('version-code', { type: 'number', describe: 'Native build/versionCode value' })
|
|
814
|
-
.option('reference-root', { type: 'string', default: 'hosanna-ui', describe: 'Installed framework/runtime root inside the app repo' })
|
|
815
|
-
.option('replace', { type: 'boolean', default: false, describe: 'Accepted for script parity; prepare never writes files' })
|
|
816
|
-
.option('dry-run', { type: 'boolean', default: false, describe: 'Accepted for script parity; prepare never writes files' })
|
|
817
|
-
.option('format', { type: 'string', choices: ['text', 'json'], default: 'text', describe: 'Output format' })
|
|
818
|
-
.option('non-interactive', { type: 'boolean', default: false, describe: 'Fail instead of prompting when a decision is needed' })
|
|
819
|
-
.example('$0 native:prepare ios', 'Validate native iOS setup before building'), async (args) => {
|
|
820
|
-
try {
|
|
821
|
-
const mod = await Promise.resolve().then(() => __importStar(require('./native/native-project.js')));
|
|
822
|
-
const result = await mod.prepareNativeProject(nativeInputFromArgs(args));
|
|
823
|
-
const format = nativeFormatArg(args);
|
|
824
|
-
console.info(format === 'json' ? JSON.stringify(result, null, 2) : mod.formatNativeDoctorReportText(result.report));
|
|
825
|
-
process.exit(0);
|
|
826
|
-
}
|
|
827
|
-
catch (err) {
|
|
828
|
-
console.error('❌ native:prepare failed');
|
|
829
|
-
console.error(err instanceof Error ? err.message : String(err));
|
|
830
|
-
process.exit(1);
|
|
831
|
-
}
|
|
832
659
|
})
|
|
833
660
|
.command('roku:package', 'Package and sign a Roku channel using roku-deploy. Flags fall back to env vars.', yargs => yargs
|
|
834
661
|
.option('ip', { type: 'string', describe: 'Roku device IP (env: ROKU_IP)' })
|
|
@@ -1528,7 +1355,7 @@ async function runEnvironmentCommand(action, verbose) {
|
|
|
1528
1355
|
console.info('Clean completed.');
|
|
1529
1356
|
process.exit(0);
|
|
1530
1357
|
})
|
|
1531
|
-
.command('generate:9patch', 'Generate 9-patch images for
|
|
1358
|
+
.command('generate:9patch', 'Generate 9-patch images for Roku UI elements', yargs => yargs
|
|
1532
1359
|
.option('output', {
|
|
1533
1360
|
type: 'string',
|
|
1534
1361
|
demandOption: true,
|
|
@@ -1839,45 +1666,11 @@ async function runEnvironmentCommand(action, verbose) {
|
|
|
1839
1666
|
console.error('❌ complib:serve failed:', err instanceof Error ? err.message : err);
|
|
1840
1667
|
process.exit(1);
|
|
1841
1668
|
}
|
|
1842
|
-
})
|
|
1843
|
-
.command('device:setup <type>', 'Run the automatable, credential-safe portion of Samsung Tizen or LG webOS device setup', yargs => yargs
|
|
1844
|
-
.positional('type', { type: 'string', choices: ['tizen', 'webos'] })
|
|
1845
|
-
.option('host', { type: 'string', demandOption: true, describe: 'TV IP address or hostname' })
|
|
1846
|
-
.option('alias', { type: 'string', default: 'myTV', describe: 'webOS ares device alias' })
|
|
1847
|
-
.option('port', { type: 'number', default: 9922, describe: 'webOS Developer Mode SSH port' })
|
|
1848
|
-
.option('username', { type: 'string', default: 'prisoner', describe: 'webOS Developer Mode SSH username' })
|
|
1849
|
-
.option('default', { type: 'boolean', default: false, describe: 'Make the webOS alias the ares default' })
|
|
1850
|
-
.option('get-key', { type: 'boolean', default: false, describe: 'Run the official interactive webOS ares-novacom key flow' })
|
|
1851
|
-
.option('signing-profile', { type: 'string', describe: 'Verify an existing external Samsung signing profile' })
|
|
1852
|
-
.option('dry-run', { type: 'boolean', default: false, describe: 'Print exact commands and manual prerequisites without changing vendor state' })
|
|
1853
|
-
.example('$0 device:setup tizen --host 192.168.1.50 --signing-profile samsung-tv-dev --dry-run', 'Preview Samsung connection/profile checks')
|
|
1854
|
-
.example('$0 device:setup webos --host 192.168.1.60 --alias living-room --get-key', 'Register an LG alias and enter the passphrase only in the official ares prompt'), async (args) => {
|
|
1855
|
-
try {
|
|
1856
|
-
const mod = await Promise.resolve().then(() => __importStar(require('./device/setup.js')));
|
|
1857
|
-
const result = await mod.setupTvDevice({
|
|
1858
|
-
cwd: process.cwd(),
|
|
1859
|
-
type: args.type,
|
|
1860
|
-
host: args.host,
|
|
1861
|
-
alias: stringArg(args.alias),
|
|
1862
|
-
port: args.port,
|
|
1863
|
-
username: stringArg(args.username),
|
|
1864
|
-
makeDefault: Boolean(args.default),
|
|
1865
|
-
getKey: Boolean(args['get-key']),
|
|
1866
|
-
signingProfile: stringArg(args['signing-profile']),
|
|
1867
|
-
dryRun: Boolean(args['dry-run']),
|
|
1868
|
-
env: process.env,
|
|
1869
|
-
});
|
|
1870
|
-
console.info(mod.formatDeviceSetupResult(result, Boolean(args['dry-run'])));
|
|
1871
|
-
}
|
|
1872
|
-
catch (error) {
|
|
1873
|
-
console.error(`❌ device:setup failed: ${error instanceof Error ? error.message : String(error)}`);
|
|
1874
|
-
process.exitCode = 1;
|
|
1875
|
-
}
|
|
1876
1669
|
})
|
|
1877
1670
|
.command('device:list', 'List devices discovered by hst, merged with .hosanna-tools/devices.json preferences', yargs => yargs
|
|
1878
1671
|
.option('type', {
|
|
1879
1672
|
type: 'string',
|
|
1880
|
-
choices: ['roku'
|
|
1673
|
+
choices: ['roku'],
|
|
1881
1674
|
describe: 'Filter devices by platform type',
|
|
1882
1675
|
})
|
|
1883
1676
|
.option('json', {
|
|
@@ -1903,60 +1696,16 @@ async function runEnvironmentCommand(action, verbose) {
|
|
|
1903
1696
|
console.error(err instanceof Error ? err.message : String(err));
|
|
1904
1697
|
process.exit(1);
|
|
1905
1698
|
}
|
|
1906
|
-
})
|
|
1907
|
-
.command('device:inspect <type>', 'Open the supported vendor inspector for an installed application', yargs => yargs
|
|
1908
|
-
.positional('type', { type: 'string', choices: ['tizen', 'webos'] })
|
|
1909
|
-
.option('device', { type: 'string', describe: 'Configured device alias, serial, IP, or name' })
|
|
1910
|
-
.option('app-id', { type: 'string', describe: 'Application id override' })
|
|
1911
|
-
.option('source-root', { type: 'string', describe: 'Staged project root containing the platform manifest' }), async (args) => {
|
|
1912
|
-
try {
|
|
1913
|
-
const mod = await Promise.resolve().then(() => __importStar(require('./device/device-cli.js')));
|
|
1914
|
-
await mod.runDeviceInspectCommand({
|
|
1915
|
-
cwd: process.cwd(),
|
|
1916
|
-
type: args.type,
|
|
1917
|
-
device: stringArg(args.device),
|
|
1918
|
-
appId: stringArg(args['app-id']),
|
|
1919
|
-
sourceRoot: stringArg(args['source-root']),
|
|
1920
|
-
env: process.env,
|
|
1921
|
-
});
|
|
1922
|
-
}
|
|
1923
|
-
catch (error) {
|
|
1924
|
-
console.error(`❌ device:inspect failed: ${error instanceof Error ? error.message : String(error)}`);
|
|
1925
|
-
process.exitCode = 1;
|
|
1926
|
-
}
|
|
1927
|
-
})
|
|
1928
|
-
.command('device:terminate <type>', 'Terminate an installed application through the supported vendor CLI', yargs => yargs
|
|
1929
|
-
.positional('type', { type: 'string', choices: ['tizen', 'webos'] })
|
|
1930
|
-
.option('device', { type: 'string', describe: 'Configured device alias, serial, IP, or name' })
|
|
1931
|
-
.option('app-id', { type: 'string', describe: 'Application id override' })
|
|
1932
|
-
.option('source-root', { type: 'string', describe: 'Staged project root containing the platform manifest' }), async (args) => {
|
|
1933
|
-
try {
|
|
1934
|
-
const mod = await Promise.resolve().then(() => __importStar(require('./device/device-cli.js')));
|
|
1935
|
-
await mod.runDeviceTerminateCommand({
|
|
1936
|
-
cwd: process.cwd(),
|
|
1937
|
-
type: args.type,
|
|
1938
|
-
device: stringArg(args.device),
|
|
1939
|
-
appId: stringArg(args['app-id']),
|
|
1940
|
-
sourceRoot: stringArg(args['source-root']),
|
|
1941
|
-
env: process.env,
|
|
1942
|
-
});
|
|
1943
|
-
}
|
|
1944
|
-
catch (error) {
|
|
1945
|
-
console.error(`❌ device:terminate failed: ${error instanceof Error ? error.message : String(error)}`);
|
|
1946
|
-
process.exitCode = 1;
|
|
1947
|
-
}
|
|
1948
1699
|
})
|
|
1949
1700
|
.command('launch <platform>', 'Restart an installed app with launch arguments, without building or installing', yargs => yargs
|
|
1950
|
-
.positional('platform', { type: 'string', choices: ['roku'
|
|
1701
|
+
.positional('platform', { type: 'string', choices: ['roku'], demandOption: true })
|
|
1951
1702
|
.option('app', { type: 'string', describe: 'Installed app selector from .hosanna-tools/run.json (env: HOSANNA_RUN_APP)' })
|
|
1952
|
-
.option('launch-arg', { type: 'array', string: true, describe: '
|
|
1953
|
-
.option('
|
|
1954
|
-
.option('
|
|
1955
|
-
.option('
|
|
1956
|
-
.option('app-id', { type: 'string', describe: 'Installed channel, bundle, or package ID; overrides project configuration' })
|
|
1703
|
+
.option('launch-arg', { type: 'array', string: true, describe: 'Roku ECP parameter, KEY=value; repeat for more values' })
|
|
1704
|
+
.option('device', { type: 'string', describe: 'Connected Roku IP or name' })
|
|
1705
|
+
.option('target', { type: 'string', choices: ['device'], describe: 'Physical Roku device' })
|
|
1706
|
+
.option('app-id', { type: 'string', describe: 'Installed Roku channel ID; overrides project configuration' })
|
|
1957
1707
|
.option('dry-run', { type: 'boolean', default: false, describe: 'Resolve the launch and print its plan without stopping or launching the app' })
|
|
1958
1708
|
.option('json', { type: 'boolean', default: false, describe: 'Print the resolved launch as JSON' })
|
|
1959
|
-
.example('$0 launch apple-tv --app demo --launch-env APP_MODE=preview --device "Demo TV"', 'Restart an installed app with a process environment value')
|
|
1960
1709
|
.example('$0 launch roku --app-id dev --launch-arg contentId=123 --device 192.168.1.50', 'Return Home and launch the sideloaded Roku app with a content ID'), async (args) => {
|
|
1961
1710
|
try {
|
|
1962
1711
|
const launcher = await Promise.resolve().then(() => __importStar(require('./run/launch-installed.js')));
|
|
@@ -1965,10 +1714,9 @@ async function runEnvironmentCommand(action, verbose) {
|
|
|
1965
1714
|
platform: args.platform,
|
|
1966
1715
|
app: args.app,
|
|
1967
1716
|
launchArgs: launcher.parseInstalledLaunchValues(args['launch-arg']),
|
|
1968
|
-
launchEnv: launcher.parseInstalledLaunchValues(args['launch-env'], '--launch-env'),
|
|
1969
1717
|
appId: args['app-id'],
|
|
1970
1718
|
device: args.device,
|
|
1971
|
-
target: args.target
|
|
1719
|
+
target: args.target,
|
|
1972
1720
|
});
|
|
1973
1721
|
if (!args['dry-run'])
|
|
1974
1722
|
await launcher.executeInstalledLaunch(plan);
|
|
@@ -1982,7 +1730,7 @@ async function runEnvironmentCommand(action, verbose) {
|
|
|
1982
1730
|
process.exit(1);
|
|
1983
1731
|
}
|
|
1984
1732
|
})
|
|
1985
|
-
.command('target:list [platform]', 'List
|
|
1733
|
+
.command('target:list [platform]', 'List physical Roku devices and Roku browser emulation', yargs => yargs
|
|
1986
1734
|
.positional('platform', {
|
|
1987
1735
|
type: 'string',
|
|
1988
1736
|
choices: RUN_PLATFORM_CHOICES,
|
|
@@ -2000,7 +1748,7 @@ async function runEnvironmentCommand(action, verbose) {
|
|
|
2000
1748
|
})
|
|
2001
1749
|
.option('form-factor', {
|
|
2002
1750
|
type: 'string',
|
|
2003
|
-
choices: ['
|
|
1751
|
+
choices: ['tv'],
|
|
2004
1752
|
describe: 'Filter by form factor for broad agent inventory queries',
|
|
2005
1753
|
})
|
|
2006
1754
|
.option('json', {
|
|
@@ -2015,15 +1763,6 @@ async function runEnvironmentCommand(action, verbose) {
|
|
|
2015
1763
|
describe: 'Output format',
|
|
2016
1764
|
})
|
|
2017
1765
|
.example('$0 target:list --platform roku', 'List Roku web emulator and device targets')
|
|
2018
|
-
.example('$0 target:list --platform ios --target emulator --json', 'List the iOS web emulator target as JSON')
|
|
2019
|
-
.example('$0 target:list --platform ios --target sim --json', 'List iOS simulator targets as JSON')
|
|
2020
|
-
.example('$0 target:list --platform ios --target device --json', 'List physical iOS device targets as JSON')
|
|
2021
|
-
.example('$0 target:list --platform android --target sim --json', 'List Android phone emulator targets as JSON')
|
|
2022
|
-
.example('$0 target:list --platform android --target device --json', 'List physical Android device targets as JSON')
|
|
2023
|
-
.example('$0 target:list --platform android-tv --target sim --json', 'List Android TV emulator targets as JSON')
|
|
2024
|
-
.example('$0 target:list --platform apple-tv --target sim --json', 'List Apple TV simulator targets as JSON')
|
|
2025
|
-
.example('$0 target:list --platform apple-watch --target sim --json', 'List Apple Watch simulator targets as JSON')
|
|
2026
|
-
.example('$0 target:list --platform wear-os --target sim --json', 'List Wear OS emulator targets as JSON')
|
|
2027
1766
|
.example('$0 target:list --form-factor tv --json', 'List TV-class targets as JSON'), async (args) => {
|
|
2028
1767
|
try {
|
|
2029
1768
|
const mod = await Promise.resolve().then(() => __importStar(require('./run/targets.js')));
|
|
@@ -2059,11 +1798,11 @@ async function runEnvironmentCommand(action, verbose) {
|
|
|
2059
1798
|
})
|
|
2060
1799
|
.positional('target', {
|
|
2061
1800
|
type: 'string',
|
|
2062
|
-
describe: 'Target kind: emulator
|
|
1801
|
+
describe: 'Target kind: Roku browser emulator or physical device.',
|
|
2063
1802
|
})
|
|
2064
1803
|
.positional('deviceSelector', {
|
|
2065
1804
|
type: 'string',
|
|
2066
|
-
describe: '
|
|
1805
|
+
describe: 'Roku IP, device name, or Roku browser preset (rokuhd/rokufhd).',
|
|
2067
1806
|
})
|
|
2068
1807
|
.option('platform', {
|
|
2069
1808
|
type: 'string',
|
|
@@ -2081,7 +1820,7 @@ async function runEnvironmentCommand(action, verbose) {
|
|
|
2081
1820
|
})
|
|
2082
1821
|
.option('device', {
|
|
2083
1822
|
type: 'string',
|
|
2084
|
-
describe: '
|
|
1823
|
+
describe: 'Roku IP, device name, or Roku browser preset for --target emulator',
|
|
2085
1824
|
})
|
|
2086
1825
|
.option('appName', {
|
|
2087
1826
|
type: 'string',
|
|
@@ -2090,13 +1829,11 @@ async function runEnvironmentCommand(action, verbose) {
|
|
|
2090
1829
|
.option('app', { type: 'string', describe: 'Run config app/flavor selector (env: HOSANNA_RUN_APP)' })
|
|
2091
1830
|
.option('profile', { type: 'string', describe: 'Build config profile (env: HS_BUILD_PROFILE)' })
|
|
2092
1831
|
.option('allow-profile-in-prod', { type: 'boolean', default: false, describe: 'Allow applying --profile with --env prod' })
|
|
2093
|
-
.option('app-config', { type: 'string', describe: 'Runtime app config selector passed to
|
|
1832
|
+
.option('app-config', { type: 'string', describe: 'Runtime app config selector passed to Roku or browser launch inputs' })
|
|
2094
1833
|
.option('shape-delivery', { type: 'string', choices: ['runtime', 'embedded', 'bundled'], describe: 'Override the build AppConfig shape delivery policy' })
|
|
2095
1834
|
.option('font-delivery', { type: 'string', choices: ['embedded', 'bundled'], describe: 'Override the build AppConfig font delivery policy' })
|
|
2096
1835
|
.option('bundle-revision', { type: 'string', describe: 'Override the build asset-bundle cache revision' })
|
|
2097
1836
|
.option('rebuild-app-config', { type: 'boolean', default: false, describe: 'Re-render AppConfig compiler assets for this build' })
|
|
2098
|
-
.option('hot-reload', { type: 'boolean', default: false, describe: 'Use native JS dev server where supported' })
|
|
2099
|
-
.option('bundled', { type: 'boolean', default: false, describe: 'Use bundled native JS/assets where supported' })
|
|
2100
1837
|
.option('vitePort', { type: 'number', description: 'Port for Vite dev server', default: 5173 })
|
|
2101
1838
|
.option('webAppPort', { type: 'number', description: 'Port for web app debugger client', default: 59151 })
|
|
2102
1839
|
.option('deviceAppPort', { type: 'number', description: 'Port for device app debugger client', default: 59152 })
|
|
@@ -2107,28 +1844,21 @@ async function runEnvironmentCommand(action, verbose) {
|
|
|
2107
1844
|
.option('dry-run', { type: 'boolean', default: false, describe: 'Print the resolved build RunPlan without executing it' })
|
|
2108
1845
|
.option('format', { type: 'string', choices: ['text', 'json'], default: 'text', describe: 'Output format for --dry-run and build result' })
|
|
2109
1846
|
.option('explain', { type: 'boolean', default: false, describe: 'Include resolution source details in text dry-run output' })
|
|
2110
|
-
.option('hsconfig', { type: 'string', describe: 'Explicit hsconfig file for Roku
|
|
1847
|
+
.option('hsconfig', { type: 'string', describe: 'Explicit hsconfig file for Roku build planning' })
|
|
2111
1848
|
.option('hsc-project', { type: 'string', describe: 'Explicit Roku HSC project file for hst build planning' })
|
|
2112
1849
|
.option('config', { type: 'string', describe: 'Back-compatible alias for --hsconfig / --hsc-project' })
|
|
2113
1850
|
.option('source-root', { type: 'string', describe: 'Roku source root to preserve in build planning output' })
|
|
2114
1851
|
.option('output-root', { type: 'string', describe: 'Project-relative root for an isolated Browser or Roku build and all generated intermediates' })
|
|
2115
1852
|
.option('build-cmd', { type: 'string', describe: 'Override the platform bundle command; parsed and executed without a shell' })
|
|
2116
|
-
.option('vite-config', { type: 'string', describe: '
|
|
2117
|
-
.option('signing-profile', { type: 'string', describe: 'External Samsung certificate profile name (env: TIZEN_SECURITY_PROFILE)' })
|
|
1853
|
+
.option('vite-config', { type: 'string', describe: 'Vite config for the Roku browser emulator' })
|
|
2118
1854
|
.option('app-id', { type: 'string', describe: 'Override the packaged TV application id for launch/inspect' })
|
|
2119
|
-
.option('connect-origin', { type: 'array', string: true, describe: 'Exact non-secret origin to allow in packaged-TV CSP/WARP; repeat as needed' })
|
|
2120
1855
|
.example('$0 build roku dev device', 'Build the dev Roku output without deploying or streaming logs')
|
|
2121
1856
|
.example('$0 build roku prod device --hsc-project platforms/hsconfig-roku.prod.json', 'Build Roku with an explicit HSC project file')
|
|
2122
|
-
.example('$0 build ios dev sim --device "iPhone 17 Pro"', 'Build an iOS simulator target without install, launch, or logs')
|
|
2123
|
-
.example('$0 build apple-watch dev sim --device "Apple Watch Series 11 (46mm)"', 'Build the paired Apple Watch simulator target')
|
|
2124
|
-
.example('$0 build wear-os dev sim --device "Wear_OS_Large_Round"', 'Build the Wear OS emulator target')
|
|
2125
1857
|
.example('$0 build browser dev emulator', 'Resolve Browser runtime build config without opening a browser')
|
|
2126
|
-
.example('$0 build roku dev device --output-root .hosanna-tools/build/roku-dev', 'Build Roku into an isolated output tree')
|
|
2127
|
-
.example('$0 build tizen dev device --signing-profile samsung-tv-dev', 'Create a signed Samsung .wgt without contacting a TV')
|
|
2128
|
-
.example('$0 build webos dev device', 'Create an LG .ipk without contacting a TV'), async (args) => {
|
|
1858
|
+
.example('$0 build roku dev device --output-root .hosanna-tools/build/roku-dev', 'Build Roku into an isolated output tree'), async (args) => {
|
|
2129
1859
|
await runRunPlanCommand('build', args);
|
|
2130
1860
|
})
|
|
2131
|
-
.command('run [platform] [env] [target] [deviceSelector]', 'Launch
|
|
1861
|
+
.command('run [platform] [env] [target] [deviceSelector]', 'Launch native Roku or Roku emulated in a browser', yargs => yargs
|
|
2132
1862
|
.parserConfiguration({ 'boolean-negation': false, 'populate--': true })
|
|
2133
1863
|
.positional('platform', {
|
|
2134
1864
|
type: 'string',
|
|
@@ -2140,11 +1870,11 @@ async function runEnvironmentCommand(action, verbose) {
|
|
|
2140
1870
|
})
|
|
2141
1871
|
.positional('target', {
|
|
2142
1872
|
type: 'string',
|
|
2143
|
-
describe: 'Target kind: emulator
|
|
1873
|
+
describe: 'Target kind: Roku browser emulator or physical device.',
|
|
2144
1874
|
})
|
|
2145
1875
|
.positional('deviceSelector', {
|
|
2146
1876
|
type: 'string',
|
|
2147
|
-
describe: '
|
|
1877
|
+
describe: 'Roku IP, device name, or Roku browser preset (rokuhd/rokufhd).',
|
|
2148
1878
|
})
|
|
2149
1879
|
.option('platform', {
|
|
2150
1880
|
type: 'string',
|
|
@@ -2162,7 +1892,7 @@ async function runEnvironmentCommand(action, verbose) {
|
|
|
2162
1892
|
})
|
|
2163
1893
|
.option('device', {
|
|
2164
1894
|
type: 'string',
|
|
2165
|
-
describe: '
|
|
1895
|
+
describe: 'Roku IP, device name, or Roku browser preset for --target emulator',
|
|
2166
1896
|
})
|
|
2167
1897
|
.option('appName', {
|
|
2168
1898
|
type: 'string',
|
|
@@ -2171,13 +1901,11 @@ async function runEnvironmentCommand(action, verbose) {
|
|
|
2171
1901
|
.option('app', { type: 'string', describe: 'Run config app/flavor selector (env: HOSANNA_RUN_APP)' })
|
|
2172
1902
|
.option('profile', { type: 'string', describe: 'Build config profile (env: HS_BUILD_PROFILE)' })
|
|
2173
1903
|
.option('allow-profile-in-prod', { type: 'boolean', default: false, describe: 'Allow applying --profile with --env prod' })
|
|
2174
|
-
.option('app-config', { type: 'string', describe: 'Runtime app config selector passed to
|
|
1904
|
+
.option('app-config', { type: 'string', describe: 'Runtime app config selector passed to Roku or browser launch inputs' })
|
|
2175
1905
|
.option('shape-delivery', { type: 'string', choices: ['runtime', 'embedded', 'bundled'], describe: 'Override the build AppConfig shape delivery policy' })
|
|
2176
1906
|
.option('font-delivery', { type: 'string', choices: ['embedded', 'bundled'], describe: 'Override the build AppConfig font delivery policy' })
|
|
2177
1907
|
.option('bundle-revision', { type: 'string', describe: 'Override the build asset-bundle cache revision' })
|
|
2178
1908
|
.option('rebuild-app-config', { type: 'boolean', default: false, describe: 'Re-render AppConfig compiler assets for this run' })
|
|
2179
|
-
.option('hot-reload', { type: 'boolean', default: false, describe: 'Use native JS dev server where supported' })
|
|
2180
|
-
.option('bundled', { type: 'boolean', default: false, describe: 'Use bundled native JS/assets where supported' })
|
|
2181
1909
|
.option('vitePort', { type: 'number', description: 'Port for Vite dev server', default: 5173 })
|
|
2182
1910
|
.option('webAppPort', { type: 'number', description: 'Port for web app debugger client', default: 59151 })
|
|
2183
1911
|
.option('deviceAppPort', { type: 'number', description: 'Port for device app debugger client', default: 59152 })
|
|
@@ -2197,11 +1925,9 @@ async function runEnvironmentCommand(action, verbose) {
|
|
|
2197
1925
|
.option('build-only', { type: 'boolean', default: false, describe: 'Plan or run build steps without opening browser/log streams where supported' })
|
|
2198
1926
|
.option('no-logs', { type: 'boolean', default: false, describe: 'Do not stream device logs after launch where supported' })
|
|
2199
1927
|
.option('build-cmd', { type: 'string', describe: 'Override the platform bundle or emulator dev command; parsed and executed without a shell' })
|
|
2200
|
-
.option('vite-config', { type: 'string', describe: '
|
|
2201
|
-
.option('signing-profile', { type: 'string', describe: 'External Samsung certificate profile name (env: TIZEN_SECURITY_PROFILE)' })
|
|
1928
|
+
.option('vite-config', { type: 'string', describe: 'Vite config for the Roku browser emulator' })
|
|
2202
1929
|
.option('app-id', { type: 'string', describe: 'Override the packaged TV application id for launch/inspect' })
|
|
2203
|
-
.option('
|
|
2204
|
-
.option('hsconfig', { type: 'string', describe: 'Explicit hsconfig file for Roku/native run planning' })
|
|
1930
|
+
.option('hsconfig', { type: 'string', describe: 'Explicit hsconfig file for Roku run planning' })
|
|
2205
1931
|
.option('hsc-project', { type: 'string', describe: 'Explicit Roku HSC project file for hst run planning' })
|
|
2206
1932
|
.option('config', { type: 'string', describe: 'Back-compatible alias for --hsconfig / --hsc-project' })
|
|
2207
1933
|
.option('app-package', { type: 'string', describe: 'Roku app .zip or folder to deploy for device runs' })
|
|
@@ -2212,29 +1938,11 @@ async function runEnvironmentCommand(action, verbose) {
|
|
|
2212
1938
|
.option('installer-password', { type: 'string', describe: 'Roku installer password (env: ROKU_DEVPASSWORD)' })
|
|
2213
1939
|
.option('logs', { type: 'boolean', default: false, describe: 'Enable verbose deploy logging where supported' })
|
|
2214
1940
|
.option('applySourceMapToPaths', { type: 'boolean', default: true, describe: 'Resolve Roku stack trace paths with source maps during log streaming' })
|
|
2215
|
-
.example('$0 run browser dev emulator', 'Start or reuse the
|
|
2216
|
-
.example('$0 run
|
|
2217
|
-
.example('$0 run webos dev emulator', 'Start or reuse the LG webOS desktop preview')
|
|
2218
|
-
.example('$0 run', 'Choose once from all available web, simulator, and physical-device destinations')
|
|
1941
|
+
.example('$0 run browser dev emulator', 'Start or reuse the Roku browser emulator')
|
|
1942
|
+
.example('$0 run', 'Choose a physical Roku or Roku browser emulation')
|
|
2219
1943
|
.example('$0 run --last', 'Immediately run on the last selected destination')
|
|
2220
1944
|
.example('$0 run --platform roku --target emulator', 'Start/reuse the Roku TV web emulator')
|
|
2221
|
-
.example('$0 run --platform ios --target emulator', 'Start/reuse the iPhone-shaped web emulator profile')
|
|
2222
|
-
.example('$0 run --platform android --target emulator --device pixel-8', 'Start/reuse the Android-shaped web emulator profile')
|
|
2223
|
-
.example('$0 run --platform apple-tv --target emulator --no-open', 'Start/reuse the Apple TV web emulator profile without opening a browser')
|
|
2224
|
-
.example('$0 run --platform android-tv --target emulator', 'Start/reuse the Android TV web emulator profile')
|
|
2225
|
-
.example('$0 run --platform ios --target sim --device "iPhone 17 Pro"', 'Build, install, and launch on an iOS simulator')
|
|
2226
|
-
.example('$0 run --platform ios --target device --device "George iPhone" --no-logs', 'Build, install, and launch on a physical iPhone')
|
|
2227
|
-
.example('$0 run --platform android --target sim --device "Pixel_8" --no-logs', 'Build, install, and launch on an Android phone emulator')
|
|
2228
|
-
.example('$0 run --platform android --target device --device "RF8M62694QT" --no-logs', 'Build, install, and launch on a physical Android device')
|
|
2229
|
-
.example('$0 run --platform android-tv --target sim --device "Television_1080p" --no-logs', 'Build, install, and launch on an Android TV emulator')
|
|
2230
|
-
.example('$0 run --platform apple-tv --target sim --device "Apple TV 4K"', 'Build, install, and launch on an Apple TV simulator')
|
|
2231
|
-
.example('$0 run --platform carplay --target sim --device "iPhone 17 Pro"', 'Launch the iPhone host and open the CarPlay Simulator display')
|
|
2232
|
-
.example('$0 run --platform android-auto --target sim --device "Pixel_8"', 'Launch Android Auto through the Desktop Head Unit')
|
|
2233
|
-
.example('$0 run --platform apple-watch --target sim --device "Apple Watch Series 11 (46mm)"', 'Build and launch through the paired Apple Watch simulator')
|
|
2234
|
-
.example('$0 run --platform wear-os --target sim --device "Wear_OS_Large_Round"', 'Build, install, and launch on a Wear OS emulator')
|
|
2235
1945
|
.example('$0 run --platform roku --target device --device "living room"', 'Build, deploy, launch, and stream logs on a Roku device')
|
|
2236
|
-
.example('$0 run tizen dev device "living room" --signing-profile samsung-tv-dev', 'Build, install, and launch on a trusted Samsung TV')
|
|
2237
|
-
.example('$0 run webos dev device "living room"', 'Build, install, and launch on a paired LG TV')
|
|
2238
1946
|
.example('$0 run roku dev device --app criterion', 'Run a configured monorepo app/flavor')
|
|
2239
1947
|
.example('$0 run roku prod device --hsc-project platforms/hsconfig.criterion.prod.json', 'Override the Roku HSC project file'), async (args) => {
|
|
2240
1948
|
await runRunPlanCommand('run', args);
|
|
@@ -2243,13 +1951,13 @@ async function runEnvironmentCommand(action, verbose) {
|
|
|
2243
1951
|
.parserConfiguration({ 'boolean-negation': false })
|
|
2244
1952
|
.option('type', {
|
|
2245
1953
|
type: 'string',
|
|
2246
|
-
choices: ['roku'
|
|
1954
|
+
choices: ['roku'],
|
|
2247
1955
|
demandOption: true,
|
|
2248
1956
|
describe: 'Target platform type',
|
|
2249
1957
|
})
|
|
2250
1958
|
.option('device', {
|
|
2251
1959
|
type: 'string',
|
|
2252
|
-
describe: '
|
|
1960
|
+
describe: 'Roku IP or case-insensitive device name',
|
|
2253
1961
|
})
|
|
2254
1962
|
.option('no-build', {
|
|
2255
1963
|
type: 'boolean',
|
|
@@ -2267,11 +1975,11 @@ async function runEnvironmentCommand(action, verbose) {
|
|
|
2267
1975
|
})
|
|
2268
1976
|
.option('app-package', {
|
|
2269
1977
|
type: 'string',
|
|
2270
|
-
describe: 'Built Roku .zip
|
|
1978
|
+
describe: 'Built Roku .zip or folder to deploy',
|
|
2271
1979
|
})
|
|
2272
1980
|
.option('app-id', {
|
|
2273
1981
|
type: 'string',
|
|
2274
|
-
describe: '
|
|
1982
|
+
describe: 'Roku application id override',
|
|
2275
1983
|
})
|
|
2276
1984
|
.option('source-root', {
|
|
2277
1985
|
type: 'string',
|
|
@@ -2300,9 +2008,7 @@ async function runEnvironmentCommand(action, verbose) {
|
|
|
2300
2008
|
describe: 'Resolve Roku stack trace paths with source maps during log streaming',
|
|
2301
2009
|
})
|
|
2302
2010
|
.example('$0 device:run --type roku', 'Build, deploy, launch, and stream Roku logs')
|
|
2303
|
-
.example('$0 device:run --type roku --device "living room" --no-build', 'Deploy to a preferred Roku by name')
|
|
2304
|
-
.example('$0 device:run --type tizen --device "living room" --no-build --app-package ./app.wgt', 'Install and launch an existing Samsung package')
|
|
2305
|
-
.example('$0 device:run --type webos --device "living room" --no-build --app-package ./app.ipk', 'Install and launch an existing LG package'), async (args) => {
|
|
2011
|
+
.example('$0 device:run --type roku --device "living room" --no-build', 'Deploy to a preferred Roku by name'), async (args) => {
|
|
2306
2012
|
try {
|
|
2307
2013
|
const mod = await Promise.resolve().then(() => __importStar(require('./device/device-cli.js')));
|
|
2308
2014
|
await mod.runDeviceRunCommand({
|