watch-tail 0.1.0

package/build/server/chunks/manifest.js-BwUys8gK.js

@@ -0,0 +1,70 @@
+const manifest = (() => {
+function __memo(fn) {
+	let value;
+	return () => value ??= (value = fn());
+}
+
+return {
+	appDir: "_app",
+	appPath: "_app",
+	assets: new Set(["robots.txt"]),
+	mimeTypes: {".txt":"text/plain"},
+	_: {
+		client: {start:"_app/immutable/entry/start._YXgjuSB.js",app:"_app/immutable/entry/app.DIoggGwf.js",imports:["_app/immutable/entry/start._YXgjuSB.js","_app/immutable/chunks/DDRhiz1-.js","_app/immutable/chunks/ZAD2y5xJ.js","_app/immutable/entry/app.DIoggGwf.js","_app/immutable/chunks/ZAD2y5xJ.js","_app/immutable/chunks/xihTtKlq.js"],stylesheets:[],fonts:[],uses_env_dynamic_public:false},
+		nodes: [
+			__memo(() => import('./nodes/0.js-Dl0J9d3p.js')),
+			__memo(() => import('./nodes/1.js-dXZVW92o.js')),
+			__memo(() => import('./nodes/2.js-aMMUenQc.js'))
+		],
+		remotes: {
+			
+		},
+		routes: [
+			{
+				id: "/",
+				pattern: /^\/$/,
+				params: [],
+				page: { layouts: [0,], errors: [1,], leaf: 2 },
+				endpoint: null
+			},
+			{
+				id: "/api/health",
+				pattern: /^\/api\/health\/?$/,
+				params: [],
+				page: null,
+				endpoint: __memo(() => import('./entries/endpoints/api/health/_server.ts.js-aiNZfkco.js'))
+			},
+			{
+				id: "/api/log-groups",
+				pattern: /^\/api\/log-groups\/?$/,
+				params: [],
+				page: null,
+				endpoint: __memo(() => import('./entries/endpoints/api/log-groups/_server.ts.js-D143-vRl.js'))
+			},
+			{
+				id: "/api/regions",
+				pattern: /^\/api\/regions\/?$/,
+				params: [],
+				page: null,
+				endpoint: __memo(() => import('./entries/endpoints/api/regions/_server.ts.js-CDNL7msU.js'))
+			},
+			{
+				id: "/api/stream",
+				pattern: /^\/api\/stream\/?$/,
+				params: [],
+				page: null,
+				endpoint: __memo(() => import('./entries/endpoints/api/stream/_server.ts.js-D_i-xW6_.js'))
+			}
+		],
+		prerendered_routes: new Set([]),
+		matchers: async () => {
+			
+			return {  };
+		},
+		server_assets: {}
+	}
+}
+})();
+
+export { manifest as m };
+//# sourceMappingURL=manifest.js-BwUys8gK.js.map

package/build/server/chunks/manifest.js-BwUys8gK.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js-BwUys8gK.js","sources":["../../../.svelte-kit/output/server/manifest.js"],"sourcesContent":["export const manifest = (() => {\nfunction __memo(fn) {\n\tlet value;\n\treturn () => value ??= (value = fn());\n}\n\nreturn {\n\tappDir: \"_app\",\n\tappPath: \"_app\",\n\tassets: new Set([\"robots.txt\"]),\n\tmimeTypes: {\".txt\":\"text/plain\"},\n\t_: {\n\t\tclient: {start:\"_app/immutable/entry/start._YXgjuSB.js\",app:\"_app/immutable/entry/app.DIoggGwf.js\",imports:[\"_app/immutable/entry/start._YXgjuSB.js\",\"_app/immutable/chunks/DDRhiz1-.js\",\"_app/immutable/chunks/ZAD2y5xJ.js\",\"_app/immutable/entry/app.DIoggGwf.js\",\"_app/immutable/chunks/ZAD2y5xJ.js\",\"_app/immutable/chunks/xihTtKlq.js\"],stylesheets:[],fonts:[],uses_env_dynamic_public:false},\n\t\tnodes: [\n\t\t\t__memo(() => import('./nodes/0.js')),\n\t\t\t__memo(() => import('./nodes/1.js')),\n\t\t\t__memo(() => import('./nodes/2.js'))\n\t\t],\n\t\tremotes: {\n\t\t\t\n\t\t},\n\t\troutes: [\n\t\t\t{\n\t\t\t\tid: \"/\",\n\t\t\t\tpattern: /^\\/$/,\n\t\t\t\tparams: [],\n\t\t\t\tpage: { layouts: [0,], errors: [1,], leaf: 2 },\n\t\t\t\tendpoint: null\n\t\t\t},\n\t\t\t{\n\t\t\t\tid: \"/api/health\",\n\t\t\t\tpattern: /^\\/api\\/health\\/?$/,\n\t\t\t\tparams: [],\n\t\t\t\tpage: null,\n\t\t\t\tendpoint: __memo(() => import('./entries/endpoints/api/health/_server.ts.js'))\n\t\t\t},\n\t\t\t{\n\t\t\t\tid: \"/api/log-groups\",\n\t\t\t\tpattern: /^\\/api\\/log-groups\\/?$/,\n\t\t\t\tparams: [],\n\t\t\t\tpage: null,\n\t\t\t\tendpoint: __memo(() => import('./entries/endpoints/api/log-groups/_server.ts.js'))\n\t\t\t},\n\t\t\t{\n\t\t\t\tid: \"/api/regions\",\n\t\t\t\tpattern: /^\\/api\\/regions\\/?$/,\n\t\t\t\tparams: [],\n\t\t\t\tpage: null,\n\t\t\t\tendpoint: __memo(() => import('./entries/endpoints/api/regions/_server.ts.js'))\n\t\t\t},\n\t\t\t{\n\t\t\t\tid: \"/api/stream\",\n\t\t\t\tpattern: /^\\/api\\/stream\\/?$/,\n\t\t\t\tparams: [],\n\t\t\t\tpage: null,\n\t\t\t\tendpoint: __memo(() => import('./entries/endpoints/api/stream/_server.ts.js'))\n\t\t\t}\n\t\t],\n\t\tprerendered_routes: new Set([]),\n\t\tmatchers: async () => {\n\t\t\t\n\t\t\treturn {  };\n\t\t},\n\t\tserver_assets: {}\n\t}\n}\n})();\n"],"names":[],"mappings":"AAAY,MAAC,QAAQ,GAAG,CAAC,MAAM;AAC/B,SAAS,MAAM,CAAC,EAAE,EAAE;AACpB,CAAC,IAAI,KAAK;AACV,CAAC,OAAO,MAAM,KAAK,MAAM,KAAK,GAAG,EAAE,EAAE,CAAC;AACtC;;AAEA,OAAO;AACP,CAAC,MAAM,EAAE,MAAM;AACf,CAAC,OAAO,EAAE,MAAM;AAChB,CAAC,MAAM,EAAE,IAAI,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC;AAChC,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC;AACjC,CAAC,CAAC,EAAE;AACJ,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,wCAAwC,CAAC,GAAG,CAAC,sCAAsC,CAAC,OAAO,CAAC,CAAC,wCAAwC,CAAC,mCAAmC,CAAC,mCAAmC,CAAC,sCAAsC,CAAC,mCAAmC,CAAC,mCAAmC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,uBAAuB,CAAC,KAAK,CAAC;AACrY,EAAE,KAAK,EAAE;AACT,GAAG,MAAM,CAAC,MAAM,OAAO,0BAAc,CAAC,CAAC;AACvC,GAAG,MAAM,CAAC,MAAM,OAAO,0BAAc,CAAC,CAAC;AACvC,GAAG,MAAM,CAAC,MAAM,OAAO,0BAAc,CAAC;AACtC,GAAG;AACH,EAAE,OAAO,EAAE;AACX;AACA,GAAG;AACH,EAAE,MAAM,EAAE;AACV,GAAG;AACH,IAAI,EAAE,EAAE,GAAG;AACX,IAAI,OAAO,EAAE,MAAM;AACnB,IAAI,MAAM,EAAE,EAAE;AACd,IAAI,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE;AAClD,IAAI,QAAQ,EAAE;AACd,IAAI;AACJ,GAAG;AACH,IAAI,EAAE,EAAE,aAAa;AACrB,IAAI,OAAO,EAAE,oBAAoB;AACjC,IAAI,MAAM,EAAE,EAAE;AACd,IAAI,IAAI,EAAE,IAAI;AACd,IAAI,QAAQ,EAAE,MAAM,CAAC,MAAM,OAAO,0DAA8C,CAAC;AACjF,IAAI;AACJ,GAAG;AACH,IAAI,EAAE,EAAE,iBAAiB;AACzB,IAAI,OAAO,EAAE,wBAAwB;AACrC,IAAI,MAAM,EAAE,EAAE;AACd,IAAI,IAAI,EAAE,IAAI;AACd,IAAI,QAAQ,EAAE,MAAM,CAAC,MAAM,OAAO,8DAAkD,CAAC;AACrF,IAAI;AACJ,GAAG;AACH,IAAI,EAAE,EAAE,cAAc;AACtB,IAAI,OAAO,EAAE,qBAAqB;AAClC,IAAI,MAAM,EAAE,EAAE;AACd,IAAI,IAAI,EAAE,IAAI;AACd,IAAI,QAAQ,EAAE,MAAM,CAAC,MAAM,OAAO,2DAA+C,CAAC;AAClF,IAAI;AACJ,GAAG;AACH,IAAI,EAAE,EAAE,aAAa;AACrB,IAAI,OAAO,EAAE,oBAAoB;AACjC,IAAI,MAAM,EAAE,EAAE;AACd,IAAI,IAAI,EAAE,IAAI;AACd,IAAI,QAAQ,EAAE,MAAM,CAAC,MAAM,OAAO,0DAA8C,CAAC;AACjF;AACA,GAAG;AACH,EAAE,kBAAkB,EAAE,IAAI,GAAG,CAAC,EAAE,CAAC;AACjC,EAAE,QAAQ,EAAE,YAAY;AACxB;AACA,GAAG,OAAO,IAAI;AACd,EAAE,CAAC;AACH,EAAE,aAAa,EAAE;AACjB;AACA;AACA,CAAC;;"}

package/build/server/chunks/nodes/0.js-Dl0J9d3p.js

@@ -0,0 +1,9 @@
+const index = 0;
+let component_cache;
+const component = async () => component_cache ??= (await import('../entries/pages/_layout.svelte.js-Bx7lXkAi.js')).default;
+const imports = ["_app/immutable/nodes/0.D5bYt7iX.js","_app/immutable/chunks/ZAD2y5xJ.js","_app/immutable/chunks/xihTtKlq.js"];
+const stylesheets = ["_app/immutable/assets/0.B1NsRRrX.css"];
+const fonts = [];
+
+export { component, fonts, imports, index, stylesheets };
+//# sourceMappingURL=0.js-Dl0J9d3p.js.map

package/build/server/chunks/nodes/0.js-Dl0J9d3p.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"0.js-Dl0J9d3p.js","sources":["../../../../.svelte-kit/output/server/nodes/0.js"],"sourcesContent":["\n\nexport const index = 0;\nlet component_cache;\nexport const component = async () => component_cache ??= (await import('../entries/pages/_layout.svelte.js')).default;\nexport const imports = [\"_app/immutable/nodes/0.D5bYt7iX.js\",\"_app/immutable/chunks/ZAD2y5xJ.js\",\"_app/immutable/chunks/xihTtKlq.js\"];\nexport const stylesheets = [\"_app/immutable/assets/0.B1NsRRrX.css\"];\nexport const fonts = [];\n"],"names":[],"mappings":"AAEY,MAAC,KAAK,GAAG;AACrB,IAAI,eAAe;AACP,MAAC,SAAS,GAAG,YAAY,eAAe,KAAK,CAAC,MAAM,OAAO,gDAAoC,CAAC,EAAE;AAClG,MAAC,OAAO,GAAG,CAAC,oCAAoC,CAAC,mCAAmC,CAAC,mCAAmC;AACxH,MAAC,WAAW,GAAG,CAAC,sCAAsC;AACtD,MAAC,KAAK,GAAG;;"}

package/build/server/chunks/nodes/1.js-dXZVW92o.js

@@ -0,0 +1,9 @@
+const index = 1;
+let component_cache;
+const component = async () => component_cache ??= (await import('../entries/fallbacks/error.svelte.js-qFLa8EVy.js')).default;
+const imports = ["_app/immutable/nodes/1.DBX83mYX.js","_app/immutable/chunks/ZAD2y5xJ.js","_app/immutable/chunks/xihTtKlq.js","_app/immutable/chunks/DCKWcE8r.js","_app/immutable/chunks/DDRhiz1-.js"];
+const stylesheets = [];
+const fonts = [];
+
+export { component, fonts, imports, index, stylesheets };
+//# sourceMappingURL=1.js-dXZVW92o.js.map

package/build/server/chunks/nodes/1.js-dXZVW92o.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"1.js-dXZVW92o.js","sources":["../../../../.svelte-kit/output/server/nodes/1.js"],"sourcesContent":["\n\nexport const index = 1;\nlet component_cache;\nexport const component = async () => component_cache ??= (await import('../entries/fallbacks/error.svelte.js')).default;\nexport const imports = [\"_app/immutable/nodes/1.DBX83mYX.js\",\"_app/immutable/chunks/ZAD2y5xJ.js\",\"_app/immutable/chunks/xihTtKlq.js\",\"_app/immutable/chunks/DCKWcE8r.js\",\"_app/immutable/chunks/DDRhiz1-.js\"];\nexport const stylesheets = [];\nexport const fonts = [];\n"],"names":[],"mappings":"AAEY,MAAC,KAAK,GAAG;AACrB,IAAI,eAAe;AACP,MAAC,SAAS,GAAG,YAAY,eAAe,KAAK,CAAC,MAAM,OAAO,kDAAsC,CAAC,EAAE;AACpG,MAAC,OAAO,GAAG,CAAC,oCAAoC,CAAC,mCAAmC,CAAC,mCAAmC,CAAC,mCAAmC,CAAC,mCAAmC;AAChM,MAAC,WAAW,GAAG;AACf,MAAC,KAAK,GAAG;;"}

package/build/server/chunks/nodes/2.js-aMMUenQc.js

@@ -0,0 +1,9 @@
+const index = 2;
+let component_cache;
+const component = async () => component_cache ??= (await import('../entries/pages/_page.svelte.js-BsvaKqbk.js')).default;
+const imports = ["_app/immutable/nodes/2.DiH-2moC.js","_app/immutable/chunks/ZAD2y5xJ.js","_app/immutable/chunks/DDRhiz1-.js","_app/immutable/chunks/xihTtKlq.js","_app/immutable/chunks/DCKWcE8r.js"];
+const stylesheets = [];
+const fonts = [];
+
+export { component, fonts, imports, index, stylesheets };
+//# sourceMappingURL=2.js-aMMUenQc.js.map

package/build/server/chunks/nodes/2.js-aMMUenQc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"2.js-aMMUenQc.js","sources":["../../../../.svelte-kit/output/server/nodes/2.js"],"sourcesContent":["\n\nexport const index = 2;\nlet component_cache;\nexport const component = async () => component_cache ??= (await import('../entries/pages/_page.svelte.js')).default;\nexport const imports = [\"_app/immutable/nodes/2.DiH-2moC.js\",\"_app/immutable/chunks/ZAD2y5xJ.js\",\"_app/immutable/chunks/DDRhiz1-.js\",\"_app/immutable/chunks/xihTtKlq.js\",\"_app/immutable/chunks/DCKWcE8r.js\"];\nexport const stylesheets = [];\nexport const fonts = [];\n"],"names":[],"mappings":"AAEY,MAAC,KAAK,GAAG;AACrB,IAAI,eAAe;AACP,MAAC,SAAS,GAAG,YAAY,eAAe,KAAK,CAAC,MAAM,OAAO,8CAAkC,CAAC,EAAE;AAChG,MAAC,OAAO,GAAG,CAAC,oCAAoC,CAAC,mCAAmC,CAAC,mCAAmC,CAAC,mCAAmC,CAAC,mCAAmC;AAChM,MAAC,WAAW,GAAG;AACf,MAAC,KAAK,GAAG;;"}

package/build/shims.js

@@ -0,0 +1,33 @@
+import buffer from 'node:buffer';
+import { webcrypto } from 'node:crypto';
+
+// `buffer.File` was added in Node 18.13.0 while the `File` global was added in Node 20.0.0
+const File = /** @type {import('node:buffer') & { File?: File}} */ (buffer).File;
+
+/** @type {Record<string, any>} */
+const globals = {
+	crypto: webcrypto,
+	File
+};
+
+// exported for dev/preview and node environments
+/**
+ * Make various web APIs available as globals:
+ * - `crypto`
+ * - `File`
+ */
+function installPolyfills() {
+	for (const name in globals) {
+		if (name in globalThis) continue;
+
+		Object.defineProperty(globalThis, name, {
+			enumerable: true,
+			configurable: true,
+			writable: true,
+			value: globals[name]
+		});
+	}
+}
+
+installPolyfills();
+//# sourceMappingURL=shims.js.map

package/build/shims.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shims.js","sources":["../node_modules/.pnpm/@sveltejs+kit@2.70.3_@sveltejs+vite-plugin-svelte@7.3.0_svelte@5.57.0_vite@8.2.2_@types_ab6e39593f61aae0ad0b9a1bac6935c7/node_modules/@sveltejs/kit/src/exports/node/polyfills.js","../.svelte-kit/adapter-node/entries/shims.js"],"sourcesContent":["import buffer from 'node:buffer';\nimport { webcrypto as crypto } from 'node:crypto';\n\n// `buffer.File` was added in Node 18.13.0 while the `File` global was added in Node 20.0.0\nconst File = /** @type {import('node:buffer') & { File?: File}} */ (buffer).File;\n\n/** @type {Record<string, any>} */\nconst globals = {\n\tcrypto,\n\tFile\n};\n\n// exported for dev/preview and node environments\n/**\n * Make various web APIs available as globals:\n * - `crypto`\n * - `File`\n */\nexport function installPolyfills() {\n\tfor (const name in globals) {\n\t\tif (name in globalThis) continue;\n\n\t\tObject.defineProperty(globalThis, name, {\n\t\t\tenumerable: true,\n\t\t\tconfigurable: true,\n\t\t\twritable: true,\n\t\t\tvalue: globals[name]\n\t\t});\n\t}\n}\n","import { installPolyfills } from '@sveltejs/kit/node/polyfills';\n\ninstallPolyfills();\n"],"names":["crypto"],"mappings":";;;AAGA;AACA,MAAM,IAAI,yDAAyD,CAAC,MAAM,EAAE,IAAI;;AAEhF;AACA,MAAM,OAAO,GAAG;AAChB,SAACA,SAAM;AACP,CAAC;AACD,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,gBAAgB,GAAG;AACnC,CAAC,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE;AAC7B,EAAE,IAAI,IAAI,IAAI,UAAU,EAAE;;AAE1B,EAAE,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,IAAI,EAAE;AAC1C,GAAG,UAAU,EAAE,IAAI;AACnB,GAAG,YAAY,EAAE,IAAI;AACrB,GAAG,QAAQ,EAAE,IAAI;AACjB,GAAG,KAAK,EAAE,OAAO,CAAC,IAAI;AACtB,GAAG,CAAC;AACJ,CAAC;AACD;;AC3BA,gBAAgB,EAAE","x_google_ignoreList":[0]}

package/dist/cli/bin.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * Executable entry point for `watch-tail`.
+ *
+ * Kept separate from {@link ./index.ts} so the module can be imported (by tests)
+ * without running anything.
+ */
+import { main } from "./index.js";
+void main();

package/dist/cli/completions.js

@@ -0,0 +1,99 @@
+/**
+ * Shell completions, powered by `@bomb.sh/tab`.
+ *
+ * `watch-tail complete <shell>` prints the script to source, and
+ * `watch-tail complete -- <words>` answers the protocol that script drives. Both
+ * paths are dispatched before normal flag parsing.
+ */
+import t from '@bomb.sh/tab';
+import { HISTORIC_PRESETS } from "../lib/time-range.js";
+import { DEFAULT_HOST, DEFAULT_PORT, FLOCI_ENDPOINT } from "./options.js";
+/** Shells `tab` can generate scripts for. */
+export const SHELLS = ['zsh', 'bash', 'fish', 'powershell'];
+/** Program name used in generated completion scripts. */
+export const PROGRAM = 'watch-tail';
+/** Regions offered for `--region`; the long tail lives in `$lib/regions.ts`. */
+const COMMON_REGIONS = [
+    'us-east-1',
+    'us-east-2',
+    'us-west-1',
+    'us-west-2',
+    'eu-west-1',
+    'eu-west-2',
+    'eu-central-1',
+    'ap-south-1',
+    'ap-southeast-1',
+    'ap-southeast-2',
+    'ap-northeast-1',
+    'af-south-1',
+    'sa-east-1',
+];
+/**
+ * Declares the CLI structure for `tab`.
+ *
+ * Safe to call repeatedly: `tab` merges commands and options into one root.
+ */
+function registerCompletionSpec(profiles = []) {
+    t.option('profile', 'AWS profile to use', function (complete) {
+        if (profiles.length === 0)
+            complete('default', 'default profile');
+        for (const name of profiles)
+            complete(name, 'AWS profile');
+    }, 'p');
+    t.option('region', 'Region to open on', function (complete) {
+        for (const region of COMMON_REGIONS)
+            complete(region, 'AWS region');
+    }, 'r');
+    t.option('endpoint', 'Emulator endpoint instead of AWS', function (complete) {
+        complete(FLOCI_ENDPOINT, 'floci');
+        complete('http://localhost:4566', 'LocalStack');
+    });
+    t.option('floci', 'Shorthand for --endpoint ' + FLOCI_ENDPOINT);
+    t.option('port', 'Port for the local UI', function (complete) {
+        complete(String(DEFAULT_PORT), 'default');
+        complete('5173', 'Vite default');
+    });
+    t.option('host', 'Interface to bind', function (complete) {
+        complete(DEFAULT_HOST, 'loopback only');
+        complete('0.0.0.0', 'all interfaces (exposes your AWS access)');
+    });
+    t.option('no-open', 'Do not open a browser window');
+    t.option('print', 'Print the environment and exit');
+    t.option('list', 'List AWS profiles and exit');
+    t.option('verbose', 'Log the server output');
+    t.option('help', 'Show help', undefined, 'h');
+    t.option('version', 'Show the version', undefined, 'v');
+    const complete = t.command('complete', 'Print a shell completion script');
+    complete.argument('shell', function (emit) {
+        for (const shell of SHELLS)
+            emit(shell, `${shell} completion script`);
+    });
+    // Historic window presets are useful for any future flag that takes a range.
+    t.command('presets', `Historic ranges: ${HISTORIC_PRESETS.join(', ')}`);
+}
+/**
+ * Handles `complete ...`.
+ *
+ * Returns the exit code for the CLI, or `null` when the words are not a
+ * completion request at all.
+ */
+export function handleCompletion(words, executable = PROGRAM) {
+    if (words.length === 0)
+        return null;
+    const [first, ...rest] = words;
+    registerCompletionSpec();
+    if (first === '--') {
+        t.parse(rest);
+        return 0;
+    }
+    if (SHELLS.includes(first)) {
+        // `tab` prints the script; `executable` is how the shell re-invokes us.
+        t.setup(PROGRAM, executable, first);
+        return 0;
+    }
+    return null;
+}
+/** The completion script for a shell, for tests and docs. */
+export function completionScript(shell, executable = PROGRAM) {
+    t.setup(PROGRAM, executable, shell);
+}

package/dist/cli/index.js

@@ -0,0 +1,183 @@
+/**
+ * `watch-tail` entry point.
+ *
+ * Responsibilities are deliberately thin: parse, resolve the AWS context, start
+ * the packaged server, wait for it to answer, open a browser and translate
+ * signals into an exit code. Everything with behaviour worth testing lives in
+ * {@link ./options.ts}, {@link ./server.ts}, {@link ./ui.ts} or
+ * `$lib/cli/aws.ts`, and the side effects are injectable through {@link CliIo}.
+ */
+import { spawn } from 'node:child_process';
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { buildChildEnv, describeChildEnv, isEmulatorEndpoint, isLocalEnvPresent, readConfigText, readProfiles, resolveRunRegion, signalExitCode, } from "../lib/cli/aws.js";
+import { handleCompletion } from "./completions.js";
+import { isLoopbackHost, parseCliArgs, usageText } from "./options.js";
+import { appRootFromHere, healthUrl, openBrowser as openBrowserDefault, startServer, stopServer, uiUrl, waitForHealth, } from "./server.js";
+import { createUi, isInteractive } from "./ui.js";
+/** Reads the version from the package manifest next to the app root. */
+export function readVersion(appRoot) {
+    const fallback = '0.0.0';
+    if (appRoot === null)
+        return fallback;
+    try {
+        const manifest = JSON.parse(readFileSync(join(appRoot, 'package.json'), 'utf8'));
+        if (typeof manifest === 'object' && manifest !== null && 'version' in manifest) {
+            const version = manifest.version;
+            if (typeof version === 'string' && version.length > 0)
+                return version;
+        }
+    }
+    catch {
+        // A missing or unreadable manifest is not worth failing over.
+    }
+    return fallback;
+}
+/** Waits for SIGINT/SIGTERM, or for the server to exit on its own. */
+function waitForStop(child) {
+    return new Promise((resolveExit) => {
+        let stopping = false;
+        const stop = () => {
+            if (stopping) {
+                // A second signal means the server is stuck: stop it hard.
+                child.kill('SIGKILL');
+                return;
+            }
+            stopping = true;
+            void stopServer(child).then(resolveExit);
+        };
+        process.on('SIGINT', stop);
+        process.on('SIGTERM', stop);
+        process.on('exit', () => {
+            if (child.exitCode === null && child.signalCode === null)
+                child.kill('SIGKILL');
+        });
+        child.on('close', (code, signal) => resolveExit(code ?? signalExitCode(signal)));
+    });
+}
+/** Real process environment for the CLI. */
+function defaultIo() {
+    const appRoot = appRootFromHere();
+    return {
+        stdout: (line) => console.log(line),
+        stderr: (line) => console.error(line),
+        env: process.env,
+        interactive: isInteractive(),
+        readProfiles: () => readProfiles(),
+        readConfigText: () => readConfigText(),
+        appRoot,
+        version: readVersion(appRoot),
+        openBrowser: (url) => openBrowserDefault(url),
+        waitForHealth,
+        startServerImpl: startServer,
+        spawnImpl: spawn,
+        waitForStop,
+    };
+}
+/** Region for this run: explicit flag, then the shell, then the profile. */
+export function resolveCliRegion(options, io) {
+    const resolved = resolveRunRegion({
+        region: options.region,
+        profile: options.profile,
+        base: io.env,
+        configText: io.readConfigText(),
+    });
+    if (resolved !== null)
+        return resolved;
+    // Emulator data is written per region and the demo fixtures live in us-east-1,
+    // so a local run that resolves nothing opens on the seeded region.
+    if (options.endpoint !== null && isEmulatorEndpoint(options.endpoint))
+        return 'us-east-1';
+    return null;
+}
+/** Runs the CLI and returns its exit code. */
+export async function run(argv, overrides = {}) {
+    const io = { ...defaultIo(), ...overrides };
+    const parsed = parseCliArgs(argv);
+    if (!parsed.ok) {
+        io.stderr(parsed.error);
+        io.stderr(usageText());
+        return 2;
+    }
+    const options = parsed.options;
+    if (options.complete !== null) {
+        const code = handleCompletion(options.complete);
+        if (code !== null)
+            return code;
+    }
+    if (options.help) {
+        io.stdout(usageText());
+        return 0;
+    }
+    if (options.version) {
+        io.stdout(io.version);
+        return 0;
+    }
+    if (options.list) {
+        const profiles = io.readProfiles();
+        for (const name of profiles)
+            io.stdout(name);
+        if (profiles.length === 0) {
+            io.stderr('No profiles found in ~/.aws/config or ~/.aws/credentials.');
+        }
+        return 0;
+    }
+    const region = resolveCliRegion(options, io);
+    const childEnv = buildChildEnv({
+        base: io.env,
+        profile: options.profile,
+        region,
+        endpoint: options.endpoint,
+    });
+    if (options.print) {
+        for (const line of describeChildEnv(childEnv))
+            io.stdout(line);
+        return 0;
+    }
+    if (io.appRoot === null) {
+        io.stderr('Could not find the built app (build/index.js). Run `pnpm build` first.');
+        return 1;
+    }
+    const ui = io.ui ?? createUi({ interactive: io.interactive });
+    const url = uiUrl(options.host, options.port);
+    ui.intro('watch-tail - CloudWatch Logs in your browser');
+    if (options.endpoint !== null) {
+        ui.info(`endpoint ${options.endpoint} (local emulator)`);
+    }
+    else if (options.profile !== null) {
+        ui.info(`profile ${options.profile}`);
+    }
+    if (region !== null)
+        ui.info(`region ${region}`);
+    if (!isLoopbackHost(options.host)) {
+        ui.warn(`binding ${options.host}: the app has no authentication and uses your AWS access, so anyone who can reach it can read your logs`);
+    }
+    if (isLocalEnvPresent(io.appRoot) && options.profile !== null) {
+        ui.warn('a .env.local with local emulator settings was found; it is ignored for this run');
+    }
+    ui.startSpinner('starting the local UI...');
+    const child = io.startServerImpl({
+        appRoot: io.appRoot,
+        env: childEnv,
+        port: options.port,
+        host: options.host,
+        verbose: options.verbose,
+    });
+    const ready = await io.waitForHealth(healthUrl(url), { fetchImpl: fetch });
+    if (!ready) {
+        ui.failSpinner(`the server did not answer on ${url}`);
+        await stopServer(child);
+        return 1;
+    }
+    ui.stopSpinner(`listening on ${url}`);
+    if (options.open)
+        io.openBrowser(url);
+    ui.outro(`${url} (Ctrl+C to stop)`);
+    const code = await io.waitForStop(child);
+    ui.outro('stopped');
+    return code;
+}
+/** Entry point used by `bin.ts`: runs the CLI and sets the exit code. */
+export async function main(argv = process.argv.slice(2)) {
+    process.exitCode = await run(argv);
+}

package/dist/cli/options.js

@@ -0,0 +1,171 @@
+/**
+ * Command-line surface of the `watch-tail` CLI.
+ *
+ * Parsing is pure so it can be unit tested: nothing here spawns a process or
+ * touches the network. {@link parseCliArgs} never throws - it returns a
+ * discriminated result the entry point turns into an exit code.
+ */
+import { parse } from '@bomb.sh/args';
+/** Port the local UI listens on unless `--port` is given. */
+export const DEFAULT_PORT = 4517;
+/** Loopback default: the app proxies your AWS permissions, so keep it local. */
+export const DEFAULT_HOST = '127.0.0.1';
+/** Local emulator the `--floci` shorthand points at. */
+export const FLOCI_ENDPOINT = 'http://localhost:4566';
+/** Flags accepted by the parser; anything else is reported as unknown. */
+const KNOWN_FLAGS = new Set([
+    '_',
+    'profile',
+    'p',
+    'region',
+    'r',
+    'port',
+    'host',
+    'endpoint',
+    'floci',
+    'open',
+    'no-open',
+    'print',
+    'list',
+    'help',
+    'h',
+    'version',
+    'v',
+    'verbose',
+]);
+function asString(value) {
+    if (typeof value === 'string') {
+        const trimmed = value.trim();
+        return trimmed.length > 0 ? trimmed : null;
+    }
+    if (typeof value === 'number' && Number.isFinite(value))
+        return String(value);
+    return null;
+}
+function asFlag(value) {
+    return value === true || value === 'true';
+}
+/**
+ * Parses `watch-tail` arguments.
+ *
+ * Accepts `--flag value` and `--flag=value`, short aliases (`-p`, `-r`, `-h`,
+ * `-v`), and the boolean negations `--open` / `--no-open`.
+ */
+export function parseCliArgs(argv) {
+    // `complete` is the shell-completion protocol, not a normal invocation. It is
+    // matched against the raw words so the literal `--` separating the two
+    // completion modes survives.
+    if (argv[0] === 'complete') {
+        return { ok: true, options: { ...defaults(), complete: argv.slice(1) } };
+    }
+    const words = argv.filter((word) => word !== '--');
+    let parsed;
+    try {
+        parsed = parse(words, {
+            alias: { p: 'profile', r: 'region', h: 'help', v: 'version' },
+            boolean: ['floci', 'open', 'no-open', 'print', 'list', 'help', 'version', 'verbose'],
+            string: ['profile', 'region', 'port', 'host', 'endpoint'],
+            default: { open: true },
+        });
+    }
+    catch (error) {
+        return { ok: false, error: error instanceof Error ? error.message : String(error) };
+    }
+    const unknown = Object.keys(parsed).filter((key) => !KNOWN_FLAGS.has(key));
+    if (unknown.length > 0) {
+        return { ok: false, error: `Unknown option "${unknown[0]}"` };
+    }
+    const positionals = Array.isArray(parsed._) ? parsed._ : [];
+    if (positionals.length > 0) {
+        return {
+            ok: false,
+            error: `Unexpected argument "${String(positionals[0])}". Run watch-tail --help for usage.`,
+        };
+    }
+    const portRaw = asString(parsed.port);
+    const port = portRaw === null ? DEFAULT_PORT : parsePortValue(portRaw);
+    if (port === null) {
+        return { ok: false, error: `Invalid --port "${portRaw}": expected 1-65535` };
+    }
+    const endpoint = asFlag(parsed.floci) ? FLOCI_ENDPOINT : asString(parsed.endpoint);
+    return {
+        ok: true,
+        options: {
+            profile: asString(parsed.profile),
+            region: asString(parsed.region),
+            port,
+            host: asString(parsed.host) ?? DEFAULT_HOST,
+            endpoint,
+            open: !asFlag(parsed['no-open']) && parsed.open !== false,
+            print: asFlag(parsed.print),
+            list: asFlag(parsed.list),
+            help: asFlag(parsed.help),
+            version: asFlag(parsed.version),
+            verbose: asFlag(parsed.verbose),
+            complete: null,
+        },
+    };
+}
+/** Defaults used by tests and by the `complete` short-circuit. */
+export function defaults() {
+    return {
+        profile: null,
+        region: null,
+        port: DEFAULT_PORT,
+        host: DEFAULT_HOST,
+        endpoint: null,
+        open: true,
+        print: false,
+        list: false,
+        help: false,
+        version: false,
+        verbose: false,
+        complete: null,
+    };
+}
+/** Parses a port, returning `null` when it is not a usable TCP port. */
+export function parsePortValue(value) {
+    const trimmed = value.trim();
+    if (!/^\d{1,5}$/.test(trimmed))
+        return null;
+    const port = Number(trimmed);
+    return port >= 1 && port <= 65535 ? port : null;
+}
+/** True when the host is loopback only. */
+export function isLoopbackHost(host) {
+    return host === 'localhost' || host === '127.0.0.1' || host === '::1' || host === '[::1]';
+}
+/** Usage text shown by `--help` and after an argument error. */
+export function usageText() {
+    return `watch-tail - tail CloudWatch Logs in your browser
+
+Usage
+  watch-tail [options]
+
+Options
+  -p, --profile <name>   AWS profile to use (default: ambient credentials)
+  -r, --region <code>    Region to open on (default: profile region, else AWS_REGION)
+      --endpoint <url>   Point the app at a local emulator instead of AWS
+      --floci            Shorthand for --endpoint ${FLOCI_ENDPOINT}
+      --port <number>    Port for the local UI (default ${DEFAULT_PORT})
+      --host <address>   Interface to bind (default ${DEFAULT_HOST}, loopback only)
+      --no-open          Do not open a browser window
+      --print            Print the environment that would be used, then exit
+      --list             List the AWS profiles found on disk, then exit
+      --verbose          Log the server's own output
+  -h, --help             Show this help
+  -v, --version          Show the version
+
+Shell completions
+  watch-tail complete <shell>      Print a completion script (zsh, bash, fish, powershell)
+  watch-tail complete -- <words>   Completion protocol used by the generated script
+
+Examples
+  npx watch-tail
+  npx watch-tail --profile my-profile --region eu-west-1
+  npx watch-tail --floci --port 4600 --no-open
+
+The app streams whatever your ambient AWS credentials can read. Credentials are
+resolved by the AWS SDK (SSO, shared config, environment, instance role); the CLI
+never stores them.`;
+}