High-performance browser automation bridge and multi-instance orchestrator with advanced stealth injection and real-time dashboard.
#!/bin/bash
# system-basic.sh — CLI config, instance, and activity happy-path scenarios.
GROUP_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
source "${GROUP_DIR}/../../helpers/cli.sh"
# ─────────────────────────────────────────────────────────────────
start_test "pinchtab instance logs"
pt_ok health --json
INSTANCE_ID=$(echo "$PT_OUT" | jq -r '.defaultInstance.id // empty')
if [ -n "$INSTANCE_ID" ]; then
pt_ok instance logs "$INSTANCE_ID"
# Logs command succeeds - output might be empty
echo -e " ${GREEN}✓${NC} instance logs succeeded"
((ASSERTIONS_PASSED++)) || true
else
echo -e " ${YELLOW}⚠${NC} No instance ID found, skipping logs test"
((ASSERTIONS_PASSED++)) || true
fi
end_test
# Note: instance start is implicitly tested (server is running)
assert_config_field() {
local path="$1" expected="$2" desc="$3"
local actual
actual=$(jq -r "$path" "$CFG" 2>/dev/null)
if [ "$actual" = "$expected" ]; then
echo -e " ${GREEN}✓${NC} $desc"
((ASSERTIONS_PASSED++)) || true
else
echo -e " ${RED}✗${NC} $desc (expected $expected, got $actual)"
((ASSERTIONS_FAILED++)) || true
fi
}
start_test "config init creates valid config"
config_setup
config_init
CFG_FILE="$CFG"
[ -f "$CFG_FILE" ] || CFG_FILE="$TMPDIR/.pinchtab/config.json"
assert_file_exists "$CFG_FILE" "config file created"
CFG="$CFG_FILE"
if jq -e '.server' "$CFG" >/dev/null 2>&1; then
echo -e " ${GREEN}✓${NC} has server section"
((ASSERTIONS_PASSED++)) || true
else
echo -e " ${RED}✗${NC} missing server section"
((ASSERTIONS_FAILED++)) || true
fi
if jq -e '.browser' "$CFG" >/dev/null 2>&1; then
echo -e " ${GREEN}✓${NC} has browser section"
((ASSERTIONS_PASSED++)) || true
else
echo -e " ${RED}✗${NC} missing browser section"
((ASSERTIONS_FAILED++)) || true
fi
config_cleanup
end_test
start_test "config show displays config"
config_setup
PINCHTAB_CONFIG="$CFG" pt_ok config show
assert_output_contains "Server" "has Server section header"
assert_output_contains "Browser" "has Browser section header"
config_cleanup
end_test
start_test "config path outputs config file path"
config_setup
EXPECTED_PATH="$TMPDIR/custom-config.json"
PINCHTAB_CONFIG="$EXPECTED_PATH" pt_ok config path
assert_output_contains "$EXPECTED_PATH" "path matches expected"
config_cleanup
end_test
start_test "config schema prints bundled schema"
pt_ok config schema
SCHEMA_URL=$(echo "$PT_OUT" | tr -d '[:space:]')
if [[ "$SCHEMA_URL" =~ ^https://raw\.githubusercontent\.com/pinchtab/pinchtab/(main|v[0-9]+\.[0-9]+\.[0-9]+)/schema/config\.json$ ]]; then
pass_assert "prints GitHub schema URL"
else
fail_assert "prints GitHub schema URL (got $SCHEMA_URL)"
fi
pt_ok config schema --print
assert_output_json "schema output is valid JSON"
assert_json_field '."$id"' "$SCHEMA_URL" 'schema $id matches URL'
assert_json_field '."$schema"' "http://json-schema.org/draft-07/schema#" 'schema $schema is draft-07'
end_test
start_test "config set updates a value"
config_setup
config_init
PINCHTAB_CONFIG="$CFG" pt_ok config set server.port 8080
assert_output_contains "Set server.port = 8080" "success message"
assert_config_field ".server.port" "8080" "file contains port 8080"
config_cleanup
end_test
start_test "config patch merges JSON"
config_setup
config_init
PINCHTAB_CONFIG="$CFG" pt_ok config patch '{"server":{"port":"7777"},"instanceDefaults":{"maxTabs":100}}'
assert_config_field ".server.port" "7777" "port set to 7777"
assert_config_field ".instanceDefaults.maxTabs" "100" "maxTabs set to 100"
config_cleanup
end_test
start_test "config validate accepts valid config"
config_setup
cat > "$CFG" <<'EOF'
{
"server": {"port": "9867"},
"instanceDefaults": {"stealthLevel": "light", "tabEvictionPolicy": "reject"},
"multiInstance": {"strategy": "simple", "allocationPolicy": "fcfs"}
}
EOF
PINCHTAB_CONFIG="$CFG" pt_ok config validate
assert_output_contains "valid" "reports valid"
config_cleanup
end_test
start_test "config validate rejects invalid config"
config_setup
cat > "$CFG" <<'EOF'
{
"server": {"port": "99999"},
"instanceDefaults": {"stealthLevel": "superstealth"},
"multiInstance": {"strategy": "magical"}
}
EOF
PINCHTAB_CONFIG="$CFG" pt_fail config validate
assert_output_contains "error" "reports error"
config_cleanup
end_test
start_test "config get retrieves a value"
config_setup
config_init
PINCHTAB_CONFIG="$CFG" pt_ok config set server.port 7654
PINCHTAB_CONFIG="$CFG" pt_ok config get server.port
assert_output_contains "7654" "got value 7654"
config_cleanup
end_test
start_test "config get fails for unknown path"
config_setup
PINCHTAB_CONFIG="$CFG" pt_fail config get unknown.field
config_cleanup
end_test
start_test "config get returns slice as comma-separated"
config_setup
config_init
PINCHTAB_CONFIG="$CFG" pt_ok config set security.attach.allowHosts "127.0.0.1,localhost"
PINCHTAB_CONFIG="$CFG" pt_ok config get security.attach.allowHosts
assert_output_contains "127.0.0.1,localhost" "got comma-separated value"
config_cleanup
end_test
start_test "config show loads legacy flat config"
config_setup
cat > "$CFG" <<'EOF'
{
"port": "8765",
"headless": true,
"maxTabs": 30
}
EOF
PINCHTAB_CONFIG="$CFG" pt_ok config show
assert_output_contains "8765" "shows port from legacy config"
config_cleanup
end_test
# ─────────────────────────────────────────────────────────────────
start_test "config token fails loudly with no clipboard"
config_setup
config_init
PINCHTAB_CONFIG="$CFG" pt_ok config set server.token "test-token-12345"
PINCHTAB_CONFIG="$CFG" pt config token
assert_exit_code 1 "exits non-zero when no clipboard tool exists"
assert_output_not_contains "test-token-12345" "token not leaked to stdout"
if echo "$PT_ERR" | grep -qi "clipboard unavailable"; then
pass_assert "stderr says the clipboard was unavailable"
else
fail_assert "stderr says the clipboard was unavailable (stderr: $PT_ERR)"
fi
if echo "$PT_ERR" | grep -q -- "--stdout"; then
pass_assert "stderr names another way to reach the token"
else
fail_assert "stderr names another way to reach the token (stderr: $PT_ERR)"
fi
config_cleanup
end_test
# ─────────────────────────────────────────────────────────────────
start_test "config token copies token to an available clipboard"
config_setup
config_init
PINCHTAB_CONFIG="$CFG" pt_ok config set server.token "test-token-12345"
CLIP_DIR=$(mktemp -d)
cat > "$CLIP_DIR/wl-copy" <<STUB
#!/bin/sh
cat > "$CLIP_DIR/copied"
STUB
chmod +x "$CLIP_DIR/wl-copy"
PATH="$CLIP_DIR:$PATH" PINCHTAB_CONFIG="$CFG" pt config token
assert_exit_code 0 "exits 0 when a clipboard tool exists"
assert_output_not_contains "test-token-12345" "token not leaked to stdout"
if echo "$PT_ERR" | grep -qi "copied to clipboard"; then
pass_assert "stderr confirms the copy"
else
fail_assert "stderr confirms the copy (stderr: $PT_ERR)"
fi
if grep -q "test-token-12345" "$CLIP_DIR/copied" 2>/dev/null; then
pass_assert "the token reached the clipboard tool"
else
fail_assert "the token reached the clipboard tool"
fi
rm -rf "$CLIP_DIR"
config_cleanup
end_test
# ─────────────────────────────────────────────────────────────────
start_test "config token fails with empty token"
config_setup
config_init
# config init now generates a token; blank it explicitly for this failure case.
TMP_CFG=$(mktemp)
jq '.server.token = ""' "$CFG" > "$TMP_CFG"
mv "$TMP_CFG" "$CFG"
# Empty token should fail.
PINCHTAB_CONFIG="$CFG" pt_fail config token
# Check error message in stderr or stdout
if printf '%s\n%s\n' "$PT_ERR" "$PT_OUT" | grep -qi "empty"; then
echo -e " ${GREEN}✓${NC} reports empty token error"
((ASSERTIONS_PASSED++)) || true
else
echo -e " ${RED}✗${NC} expected empty token error message"
((ASSERTIONS_FAILED++)) || true
fi
config_cleanup
end_test
# ─────────────────────────────────────────────────────────────────
start_test "pinchtab activity"
pt_ok nav "${FIXTURES_URL}/buttons.html"
TAB_ID=$(echo "$PT_OUT" | tr -d '[:space:]')
pt_ok snap --tab "$TAB_ID" --full
assert_output_json "snapshot output is valid JSON"
pt_ok click --tab "$TAB_ID" "#increment"
assert_output_contains "OK" "click command completed"
pt_ok activity --limit 100
assert_output_json "activity output is valid JSON"
assert_output_contains "\"events\"" "returns events payload"
assert_output_has_tab_event \
"$TAB_ID" \
"/tabs/${TAB_ID}/action" \
"activity output includes tab-scoped action event" \
"activity output missing tab-scoped action event for ${TAB_ID}"
end_test
# ─────────────────────────────────────────────────────────────────
start_test "pinchtab activity tab <id>"
pt_ok activity --limit 100 tab "$TAB_ID"
assert_output_json "tab activity output is valid JSON"
assert_output_all_events_for_tab \
"$TAB_ID" \
"tab activity output is scoped to selected tab" \
"tab activity output includes other tabs"
assert_output_has_tab_event \
"$TAB_ID" \
"/snapshot" \
"tab activity output includes snapshot event" \
"tab activity output missing snapshot event"
end_test
# ─────────────────────────────────────────────────────────────────
start_test "pinchtab activity (no events scenario)"
# Fetch activity with a very small limit to test pagination
pt_ok activity --limit 1
assert_output_json "activity with limit 1 is valid JSON"
assert_output_contains "\"events\"" "returns events array even with limit 1"
end_test
# ─────────────────────────────────────────────────────────────────
start_test "pinchtab activity tab (non-existent tab)"
# Try to get activity for a tab that doesn't exist
pt activity tab "nonexistent_tab_xyz_12345" --limit 10
# Should fail gracefully or return empty events
if [ "$PT_CODE" -eq 0 ]; then
assert_output_json "output is valid JSON even for non-existent tab"
echo -e " ${GREEN}✓${NC} handled non-existent tab gracefully"
((ASSERTIONS_PASSED++)) || true
else
echo -e " ${GREEN}✓${NC} correctly rejected non-existent tab"
((ASSERTIONS_PASSED++)) || true
fi
end_test