@ekrooh/bare 0.2.0 → 0.4.0

package/README.md

@@ -206,6 +206,24 @@ npm run build       # core bundle + web assets
 
 `./gradlew build` additionally runs the host library's JUnit tests.
 
+### Consuming the published AAR
+
+`io.github.anderscan.ekrooh:bare-host` is published to **Maven Central** (no auth) on the same
+tag as the npm package — pin it to your `@ekrooh/bare` version:
+
+```gradle
+repositories {
+  mavenCentral() // default in modern Gradle; no credentials needed
+}
+
+dependencies {
+  implementation "io.github.anderscan.ekrooh:bare-host:<version>"
+}
+```
+
+GitHub Packages (`maven.pkg.github.com/AndersCan/ekrooh`) remains a fallback
+but requires a `read:packages` PAT — prefer Maven Central.
+
 ## iOS build
 
 Prerequisites: Xcode (macOS), Bare Kit prebuilds, and `xcodegen`.

package/dist/runtime.d.mts

@@ -48,11 +48,27 @@ declare function getIPC(): BareIPC;
 //#endregion
 //#region core/runtime.d.ts
 /** Resolves the host-provided worklet configuration from `start(...)`
- * arguments. On-device hosts pass `["<webAssets>", "<storage>", "<cache>"]`,
- * landing at `Bare.argv[0..2]`; the Bare CLI (dev) passes the binary and the
- * script path instead, so a missing/absent config means dev mode (auth off,
- * fixed port, no handoff file). */
+ * arguments. On-device hosts pass `["<webAssets>", "<storage>", "<cache>"]`
+ * (three existing directories, in that order), landing at `Bare.argv[0..2]`;
+ * the Bare CLI (dev) passes the binary and the script path instead, so a
+ * missing/absent config means dev mode (auth off, fixed port, no handoff
+ * file). Falls back to the labeled CLI token syntax (see `resolveCliConfig`)
+ * when the positional shape doesn't match, so the same entry works for both
+ * device and dev runs. */
 declare function resolveWorkletConfig(): WorkletRuntimeOptions;
+/**
+ * Parses the dev/CLI labeled-token configuration from bare CLI arguments:
+ * `webassets=<dir>`, `storage=<dir>`, `cache=<dir>`, `host=<addr>`,
+ * `port=<n>`, `auth=<on|off|true|false|1|0>` — a single `key=value` separator.
+ * Unknown labels (e.g. `bootstrap=127.0.0.1:49737`) are ignored and stay
+ * consumer-owned.
+ *
+ * Returns the equivalent `WorkletRuntimeOptions` in **dev mode**: `deviceMode:
+ * false` (so a `storage=` token does not flip auth on or make the port
+ * ephemeral), `auth: false`, `port: 8080`, each overridable by a token. When
+ * no labeled tokens are present it returns `{}` (plain dev defaults).
+ */
+declare function resolveCliConfig(argv?: readonly string[]): WorkletRuntimeOptions;
 type WorkletRuntimeOptions = {
   /** Directory to serve at `/` (the built web app). */
   webAssets?: string;
@@ -67,6 +83,10 @@ type WorkletRuntimeOptions = {
   port?: number;
   /** Require the per-session token/cookie. Defaults to on in device mode. */
   auth?: boolean;
+  /** Explicit device-mode override. Defaults to on whenever `storage` is set
+   * (the on-device 3-arg contract); `resolveCliConfig` resolves it to false so
+   * a dev backend keeps auth off + fixed port even with a storage dir. */
+  deviceMode?: boolean;
   /** Additional plugin manifests to register after the canonical defaults
    * (consumer product plugins, e.g. `app.photos`). */
   plugins?: PluginManifest[];
@@ -103,4 +123,4 @@ interface WorkletRuntime {
  */
 declare function createWorkletRuntime(options?: WorkletRuntimeOptions): WorkletRuntime;
 //#endregion
-export { type LoopbackPush, type LoopbackRouteHandler, type LoopbackServer, WorkletRuntime, WorkletRuntimeConfig, WorkletRuntimeOptions, attachWebSocketProtocol, collectRequestBody, createLoopbackPush, createLoopbackServer, createWorkletRuntime, getIPC, resolveWorkletConfig };
+export { type LoopbackPush, type LoopbackRouteHandler, type LoopbackServer, WorkletRuntime, WorkletRuntimeConfig, WorkletRuntimeOptions, attachWebSocketProtocol, collectRequestBody, createLoopbackPush, createLoopbackServer, createWorkletRuntime, getIPC, resolveCliConfig, resolveWorkletConfig };

package/dist/runtime.mjs

@@ -547,13 +547,19 @@ function attachWebSocketProtocol(server, context) {
 }
 //#endregion
 //#region core/runtime.ts
+function readBareArgv() {
+	return typeof Bare !== "undefined" && Array.isArray(Bare.argv) ? Bare.argv : [];
+}
 /** Resolves the host-provided worklet configuration from `start(...)`
-* arguments. On-device hosts pass `["<webAssets>", "<storage>", "<cache>"]`,
-* landing at `Bare.argv[0..2]`; the Bare CLI (dev) passes the binary and the
-* script path instead, so a missing/absent config means dev mode (auth off,
-* fixed port, no handoff file). */
+* arguments. On-device hosts pass `["<webAssets>", "<storage>", "<cache>"]`
+* (three existing directories, in that order), landing at `Bare.argv[0..2]`;
+* the Bare CLI (dev) passes the binary and the script path instead, so a
+* missing/absent config means dev mode (auth off, fixed port, no handoff
+* file). Falls back to the labeled CLI token syntax (see `resolveCliConfig`)
+* when the positional shape doesn't match, so the same entry works for both
+* device and dev runs. */
 function resolveWorkletConfig() {
-	const argv = typeof Bare !== "undefined" && Array.isArray(Bare.argv) ? Bare.argv : [];
+	const argv = readBareArgv();
 	const webAssets = argv[0];
 	const storage = argv[1];
 	const cache = argv[2];
@@ -561,7 +567,7 @@ function resolveWorkletConfig() {
 		const isDir = (p) => fs.statSync(p).isDirectory();
 		if (isDir(webAssets) && isDir(storage)) {
 			const cacheDir = typeof cache === "string" && isDir(cache) ? cache : storage;
-			if (cacheDir !== cache) console.warn("[bare] cache dir missing or not a directory; falling back to the storage dir");
+			if (cacheDir !== cache) console.warn("[bare] cache dir missing or not a directory; falling back to the storage dir. Pass three dirs in order to the worklet: [webAssets, storage, cache].");
 			return {
 				webAssets,
 				storage,
@@ -569,7 +575,57 @@ function resolveWorkletConfig() {
 			};
 		}
 	} catch {}
-	return {};
+	return resolveCliConfig(argv);
+}
+/**
+* Parses the dev/CLI labeled-token configuration from bare CLI arguments:
+* `webassets=<dir>`, `storage=<dir>`, `cache=<dir>`, `host=<addr>`,
+* `port=<n>`, `auth=<on|off|true|false|1|0>` — a single `key=value` separator.
+* Unknown labels (e.g. `bootstrap=127.0.0.1:49737`) are ignored and stay
+* consumer-owned.
+*
+* Returns the equivalent `WorkletRuntimeOptions` in **dev mode**: `deviceMode:
+* false` (so a `storage=` token does not flip auth on or make the port
+* ephemeral), `auth: false`, `port: 8080`, each overridable by a token. When
+* no labeled tokens are present it returns `{}` (plain dev defaults).
+*/
+function resolveCliConfig(argv = readBareArgv()) {
+	const parsed = {};
+	let matched = false;
+	for (const token of argv) {
+		const m = /^([A-Za-z][A-Za-z0-9]*)=(.*)$/.exec(token);
+		if (!m) continue;
+		const [, key, value] = m;
+		matched = true;
+		switch (key) {
+			case "webassets":
+				parsed.webAssets = value;
+				break;
+			case "storage":
+				parsed.storage = value;
+				break;
+			case "cache":
+				parsed.cache = value;
+				break;
+			case "host":
+				parsed.host = value;
+				break;
+			case "port": {
+				const n = Number(value);
+				if (Number.isInteger(n) && n >= 0 && n <= 65535) parsed.port = n;
+				else console.warn(`[bare] ignoring invalid port= token: "${value}"`);
+				break;
+			}
+			case "auth": parsed.auth = value !== "off" && value !== "false" && value !== "0";
+		}
+	}
+	if (!matched) return {};
+	return {
+		deviceMode: false,
+		auth: false,
+		port: 8080,
+		...parsed
+	};
 }
 function toUint8Array(data) {
 	if (data instanceof Uint8Array) return data;
@@ -587,7 +643,7 @@ function writeIpc(ipc, bytes) {
 * wire p2p". Mirrors the reference wiring in `core/main.core.ts`.
 */
 function createWorkletRuntime(options = {}) {
-	const deviceMode = options.storage !== void 0;
+	const deviceMode = options.deviceMode ?? options.storage !== void 0;
 	const auth = options.auth ?? deviceMode;
 	const port = options.port ?? (deviceMode ? 0 : 8080);
 	const protocol = new MessageProtocol({
@@ -670,4 +726,4 @@ function createWorkletRuntime(options = {}) {
 	};
 }
 //#endregion
-export { attachWebSocketProtocol, collectRequestBody, createLoopbackPush, createLoopbackServer, createWorkletRuntime, getIPC, resolveWorkletConfig };
+export { attachWebSocketProtocol, collectRequestBody, createLoopbackPush, createLoopbackServer, createWorkletRuntime, getIPC, resolveCliConfig, resolveWorkletConfig };

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@ekrooh/bare",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "type": "module",
-  "description": "One soul, many platforms — the boring bootstrap for cross-platform apps on the Bare runtime: wire protocol, plugin kernel, RPC messenger, transports, and native host bridges.",
+  "description": "One soul, many platforms \u2014 the boring bootstrap for cross-platform apps on the Bare runtime: wire protocol, plugin kernel, RPC messenger, transports, and native host bridges.",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -10,6 +10,7 @@
   },
   "workspaces": [
     "examples/*",
+    "examples/consumer-basic",
     "e2e",
     "apps/*"
   ],
@@ -36,9 +37,10 @@
     "docs:preview": "vp run docs#preview",
     "docs:check": "node scripts/docs-check.mjs",
     "typecheck": "tsc --noEmit",
-    "test": "vp test && npm run test:e2e:web && npm run test:e2e:harness",
+    "test": "vp test && npm run test:e2e:web && npm run test:e2e:harness && npm run test:e2e:consumer",
     "test:unit": "vp test",
     "test:e2e:web": "node scripts/playwright-local-browsers.mjs test",
+    "test:e2e:consumer": "node scripts/playwright-local-browsers.mjs test --config examples/consumer-basic/playwright.config.ts",
     "dev": "concurrently \"vp -C examples/web dev\" \"npm run dev:bare\"",
     "predev": "npm run build:pkg",
     "dev:bare": "node scripts/dev-bare.mjs",
@@ -87,7 +89,7 @@
   },
   "dependencies": {
     "@mantaq/core": "^0.2.0",
-    "@mantaq/sugar": "^0.2.0",
+    "@mantaq/sugar": "^0.3.0",
     "bare-crypto": "^1.15.3",
     "bare-encoding": "^1.0.3",
     "bare-env": "^3.0.0",